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If You Don't Read This Manual 


Not reading the manual can present hazards to your 
equipment and to the data you are putting on tape. 

At a minimum: 

■ Review the introduction 

■ Skim over the sections that affect your application to make 
certain that you take any precautions needed. 


I 






where to Look for Information 
(When All Else Fails) 


Many people don't read manuals; at least, not all at once. 

When you are looking for specific information, check the table of 
contents. It is likely this will lead you to that information. 

Note: We try to keep our user documentation up to date. 
However, last-minute changes may supercede this manual. 
Read any addenda included with the manual, and read the 
readme. doc file on the release disk before using the utilities. 


Overview 


Conventions 

Throughout this manual, we use the following conventions; 
input Something you must type from the keyboard is 
shown bold in this constant width typeface. 

(ENTER) This typeface that shows the name of the key on 
your keyboard in an oval, such as (enter) or (ctrD- 
( ) indicates the spacebar. 

(ctrQ+e When you need to press two keys together, we 
show a both keys, joined by a plus, 
prompt The program's prompts, and information displayed 
on-screen is shown using this typeface. 


Installation and Testing 

■ For information on installing, configuring and testing: 

• TX-8, see page 14. • TXi-16, see page 24. 

■ X\J2, see page 35. 

Subsystem Test Tools 

■ XTEST tests the integrated TX-8, Xl/2 or TXi-16 tape 
subsystem; see page 41. 

■ WHAT shows each source module's version in the tape 
programs; see page 43. 


Easy Operation 

■ For menu driven access to the tape utility programs, see 
DEPOT4 on page 46 . 






Data Interchange 

• For simple, menu driven applications; depot, page 52. 

■ For a 'batch' file application; depot2, page 60. 

■ For record-level data transformations; depots, page 71. 

■ To examine a 'mystery tape," see fddmp on page 84. 

■ To write IBM or ANSI labeled tapes; label, page 92, or 
TAPEUTL, page 101. 

■ For visually oriented tape interchange; tapeview (optional) 
in the (separate) tapeview manual. 

Hard Disk Backup 

■ To backup a hard disk to tape, see tar, page 175. 

■ For enhanced backup from hard disk to tape, see flashbak 
(optional), in the (separate) Tape Options manual. 

■ For network backup (network backup is only available with 
the enhanced software of the TXi-16, TX-8 and the XLy2 
boards or as an option), see Novell tar, in the (separate) 
Tape Options manual. 

Tape Programming Utilities 

All Of the Tape Programming Utilities are included in the 

(separate) Tape Options manual. 

■ To write custom tape programs in TurboPascal, Microsoft 
Ouick Basic, IBM Professional Fortran, Microsoft Fortran 
and Microsoft C see the ms-dos device driver. 

■ To write "low level" custom tape programs in Microsoft C see 

ALLTAPE. 

■ Tcopy provides the ability to copy from tape to tape (needs 
two drives, two controllers and two DOS device drivers). 

■ TDisK lets a tape drive function somewhat like a disk drive. 

UNIX/XENIX 286 or 386 

■ Refer to the (separate & optional) UNIX Tape Package 
manual. 

Custom Configuration 

■ For Controller Model TX-8, see Appendix A page A-5 

■ For Controller Model XLy2, see /^Dpendix A, page A-8 

■ To reconfigure the software, see Config in Chapter 2. 

Warranty Information 

■ For warranty information, see Appendix B, page B-1. 


IV 



The following notice applies to all Overland Data tape drive 
controller cards; the TX-8, TXi-16, and XI72. All have been 
tested and meet the standards for Class A computing 
equipment. 


WARNING —This equipment generates, uses and can 
radiate radio frequency energy and if not installed and 
used in accordance with the instructions manual, may 
cause interference to radio communications. It has 
been tested and found to comply with the limits for a 
Class A computing device pursuant to Subpart J of Part 
15 of the FCC Rules, which are designed to provide 
reasonable protection against such interference when 
operated in a commercial environment. Operation of 
this equipment in a residential area is likely to cause 
interference in which case the user at his own expense 
will be required to take whatever measures may be 
required to correct the interference. 


V 
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Chapter 1—An Introduction to 9-Track Tape 

About 9-Track Tape 

Nine-track tape has a special status for mainframes and mini¬ 
computers. The drive interface and recording technique are 
standard, so data interchange with 9-track tape is easy, and an 
alternative to direct links between PCs, mainframes and mini¬ 
computers. To move data from "large" computers to PCs, write 
a 9-track tape and then read it on your personal computer. 

Moving data to a mainframe or mini-computer is just as easy. 

Overland Data 9-Track Products 

We offer subsystems (software, controller card and 9-track tape 
drive) that add 9-track tape to your PC. We offer the TX-8 for 
PC XT, AT, and 286/386-class machines; the TXi-l 6 for PC AT 
286/386/486 and compatible Compaq EISA 486 (16 bit slot) 
machines; and the XLy2 for PS/2 Micro Channel /Vchitecture 
machines. Chapter 2 describes installation and configuration. 

Flashbak: High Speed Backup & Restore 

Flashbak is an interactive, window-oriented tape backup and 
restore utility, allowing you to: examine your disk directory 
structure and file names, select files that match a set of file 
names for backup or restore, tag modified files for backup, or 
select only the files in a subtree. Flashbak does not support 
network backup—for network backup, see Novell Tar, below. 

Novell Tar: 286 Novell Network Backup 

Novell Tar is an upgraded version of the Tar utility included in 
this pacakge which allows you to backup and restore 286 Novell 
networks (it does not support 386 Novell). The DEPOT4 
program included in this package will access and work with 
Novell Tar, providing the same user friendly interface. 

MS-DOS 9-Track Programming Toolkit 

This is a tool set giving access to the the programming interface 
for your tape controller. These include an installable "character" 
device driver allowing you to use DOS calls to read, write and 
position the tape drive; an object module linked to your 
application; and a "block" device driver providing limited access 
to tape drives for programs which are not "tape-aware." 
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UNIX and XENIX Support 

We offer an installable device driver for your SCO XENIX 286 or 
386, Microport System V/AT, Microport System \//386 or 
Interactive UNIX 386 system. This lets you use the standard 
utilities, dd, tar, and cpio for interchange and backup. See the 
UNIX/XENIX Reference Manual for information. The TX-8 and TXi- 
16 support UNIX, while XENIX operates only on the TX-8. 

TapeVlew: Enhanced Data Interchange 

We offer a powerful tape interchange utility, TapeView—a 
window-oriented program that lets you visually define records 
and fields and specify field-level translations. TapeView writes 
QuickBASIC programs to perform requested data transfer and 
translations. QuickBASIC-compatible libraries allow you to write 
custom programs or modify TapeView-produced programs. 
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Details About 9-Track Tape 

Since 9-tracl< drives use a standard format, software relies on 
consistent tape format and physical attributes. 

Physical Characteristics of 9-Track Tape 

Tape reel diameters are usually 10'/^, 8'/^ or 7 inches. A I O'/i inch 
reel holds 2400 or 3600 feet of tape, depending on tape 
thickness. The 2400-foot tape is most common. A 7 inch reel 
holds 600 feet. Some tape drives can only use the smaller reel 
size (lengths are for new tapes; used tapes may be shorter for 
several reasons). 

Each reel has two reflective strips on the back of the tape. The 
Beginning of Tape (BOT) marker is about 15 feet from the start 
of the tape. Tape drives "see" this marker and place the head 
just past it when loading or rewinding. The End of Tape (EOT) 
marker is about 15 feet from the tape's end. The EOT marker 
warns software that the tape end is near. Drives can record 
past this, but must stop fast to keep the tape from coming off 
the reel. 

Occasionally BOT or EOT markers are damaged. Note the 
position of the marker on the tape carefully before replacing it. 

Data is recorded in "blocks" separated by a small amount of 
blank tape called an inter-record gap (IRQ). A file is one or more 
blocks separated from the next file by a special block called a 
filemark (or filemark). Two filemarks signal the end of data 
(called logical EOT)—usually before physical EOT. No data 
should be recorded past logical EOT. To avoid tape coming off 
the supply reel, logical EOT should appear soon after the EOT 
marker. 

9-track drives have a "safety," to prevent writing over data on 
tape. Usually, a tape is "write-protected" if it lacks a write ring in 
the back of the reel (the ring allows writing). A reel without the 
ring keeps the drive from writing. Some drives ignore the write 
ring and use a file protect switch on the drive front panel 
instead. 

Tape Format and Density 

Density is measured in bytes-per-inch (bpi), the bytes of data on 
an inch of tape. This is the data density, ignoring IRGs. The 
format describes the recording technique used by the drive. 

There are three standard formats: 
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■ NRZI (non-return to zero inverted): 

The oldest and least common format; density is 800 bpi. 

■ PE (phase-encoded); 

Recording density is 1600 bpi or 3200 bpi. 1600 bpi is most 
common for data interchange. 3200 bpi is used for backup 
(because twice as much data fits on a tape reel) and is not 
as commonly used for interchange. 

■ GCR (group-coded recording): 

GCR records at 6250 bpi. GCR is a common interchange 
format, especially between mainframes. With almost four 
times 1600 bpi's data capacity, it is a good backup choice. 
Many drives support several densities. These are described as 
single-, double- tri- or quad-density. 


Data Bytes 

9-track drives write nine parallel data tracks for each data byte; 
one for each of the eight bits and one for parity. The parity 
track is used to detect read and write errors (and to correct 
read errors). 


Tape Capacity 

Tape capacity depends on tape length, block size, IRG size, and 
density. The formula for computing tape capacity is as follows; 


TAPECAPACITY = 


TAPE LENGTH 
BLOCKSIZE 
DENSITY 


X BLOCKSIZE 


TAPECAPACITY 

TAPELENGTH 

BLOCKSIZE 

DENSITY 

IRG 


is tape capacity measured in bytes 

is the tape length measured in inches 

is the block size measured in bytes 

is the recording density measured in bytes per inch 

is the length of the inter-record gap in inches. 


This table lists tape capacity for various block sizes for 1600 and 
3200 bpi, assuming a 0.6 inch IRG and a 2400-foot reel of tape. 


Density (bpi) 

512 

1024 

Block Size (bytes) 
3072 5120 

10240 

16384 

1600 


23.7 

35.1 

38.8 

42.1 

43.5 

3200 


32.0 

56.7 

67.0 

77.6 

82.4 
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Tape Layout 

The combination of filemarks and data blocks is the tape layout. 

Unlabeled Tapes 

The generic layout is "unlabeled tape." For example, a tape with 
a single file. The file contains blocks separated by IRGs and 
ended by two filemarks. This diagram shows such a file, of N 
blocks. 

RIe MaH<s 


BOT IRQ IRQ IRQ (logical EOT) EOT 



Some tapes are written with an initial file mark, as follows: 


RIe RIe Marks 

BOT Mark IRQ IRQ (logical EOT) EOT 



Tapes with two or more files use the same format (one filemark 
between files; two filemarks after the last file showing the logical 
EOT. The blocks are separated by IRGs. This diagram shows the 
layout for three files (we just show files and filemarks). 


RIe File File Marks 

BOT Mark Mark (logical EOT) EOT 




■ 




M 





Rle1 

V 

RIe 2 


Files 

w 
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Labeled Tapes 

In general, labeled tapes have at least three files a header file 
describing the data, a data file and a trailer file. Other data files 
may follow with the same format: header, data and trailer. This 
diagram shows a labeled tape with a single data file. 
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File File File Marks 

BOT Mark Mark (logical EOT) EOT 



There are two standards, IBM and ANSI. IBM specifies labels 
(header and trailer) hold only EBCDIC characters. ANSI specifies 
labels use ASCII characters only. Labels are 80-byte blocks and 
both standards define similar information in the headers and 
trailers. For the IBM standard, refer to IBM Publication OS/VS 
Tape Labels, GC26-3795-3, available from the IBM branch office 
for your area. For the ANSI standard, refer to American 
National Standard Magnetic Tape Labels and File Structure for 
Information Interchange X3.27-1978. Copies may be ordered 
from; American National Standards Institute, 1430 Broadway, 
New York, NY 10018 

For both, the label header is a header file of at least three 80- 
byte blocks. Further blocks are optional user-defined labels. 

Re Re ReMarte 


BOT MaiK (logical EOT) EOT 



These blocks are; volume label (VOL1), header 1 label (HDRl) 
and header 2 label (HDR2). Optional user labels (UHLI—UHL8) 
follow (not supported by label. The file ends with a filemark. 
The header and trailer labels use identical formats, except that 
there is no VOLl trailer. End of file trailer 1 (EOFI) follows the 
data file and filemark. It has the same format as the FIDRl 
label. The end of file trailer 2 (EOF2) follows EOFI. Any user 
trailers, called UTLl through UTL8, follow EOF2. Two filemarks 
end the last trailer. 
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Tape Data 

Here is an analogy between tape data and a filing cabinet. 

Each drawer is a reel of tape. It contains one or more files. A file 
in the drawer is marked with a tab. Such tabs are similar to the 
tape's filemarks. The data between the tabs may be divided into 
manila folders, each of which is like a block of data on tape. 

Each folder can have many pieces of paper in it, and this is 
similar to having several logical records in a block on tape. 

Data Blocks 

The unit of data on tape is a data block. Sometimes, people use 
"record" when referring to a block. In this document, we use 
the term block for the data on tape, surrounded by the IRGs. 

We use the term record for the logical grouping of the data. In 
many cases the record size is the same as the block size; that is, 
a block contains a single record. More often, blocks contain 
multiple records (20, 100, 500, etc.). The number of records per 
block is the blocking factor and the block size is an even multiple 
of the record size. Typically, a program writes data to tape in a 
series of fixed-sized blocks, ending the data transfer with two 
filemarks. 

The IBM standard for variable-sized blocks requires a 4-byte 
header (in zoned decimal), showing the block size, before the 
data. The block length includes the 4-byte header. If the data 
length is 2,000 bytes, the block length header contains the 
value "2004". 

Choosing an Appropriate Block Size 

There is not a "correct" block size, but a range of sizes 
appropriate for an application. If the data is in fixed-size 
records, the block size will be a multiple of the record size. If we 
have a database of 10,000 records and each record is 230 
bytes long, we can pick a block size that is an even multiple of 
230 (such as 230, 4600, etc.). Remember: block size affects tape 
capacity and tape drive data rate (the larger the block size, the 
higher the tape capacity and the higher the tape drive data 
rate). Here, 4600 is a "medium-sized" block, offering acceptable 
tape capacity and tape drive data rate and high compatibility 
within an unknown configuration. 
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Records 

A record is a logical data grouping. There are fixed length and 
variable length records. Fixed length records are convenient for 
writing to tape (accommodating blocking characteristics). 

Often, data is fixed-size because it is stored that way in a 
database. If the data is not fixed-size (e.g., a text file), we can 
place each line of text in a record (say, 100 bytes) and "blank- 
pad” the record to size. 

IBM-format, variable-size records use a 4-byte header (in zoned 
decimal) before the data, showing the record length (including 
header). This is used with the variable-size blocks. Such a block 
has a 4-byte block size indicator, a 4-byte record size indicator, 
and the first record's data. The next record appears with a 4- 
byte record size indicator followed by that record's data. 

Data Fields 

We can break up a data record into individual fields. For fixed- 
size records, each record has the same number and sizes of 
fields. Different fields, however, have various sizes and formats. 
If the entire record is character data, each field will consist of 
ASCII or EBCDIC values. It's possible for the fields to be a 
number format, such as Binary Coded Decimal (BCD), binary 2- 
byte integer, binary 4-byte integer, or one of several floating 
point formats. The next section discusses standard formats 
found in 9-track tape data. 


Tape Formats 

This section shows you the standard formats that you're likely 
to run across while reading and writing 9-track tapes. 


Format 

Size 

(bytes) 

Format 

Size 

(bytes) 

Integer 

1, 2 or 4 


open 

Unsigned integer 

1, 2 or 4 


open 

Microsoft Floating 
Point 

4 or 8 

CompS 

open 

mOBBSaSBISiBfl 

4 or 8 
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Format Specifications 


Signed integers 

Signed integers all use the leftmost bit as a sign bit (1 for 
negative, 0 for positive). 

■ One Byte Signed 

One byte integer values range from -128 (0x80) to +127 
(0x7F). They are 8 bits wide. 

■ Two Byte Signed 

Two byte integer values range from -32,768 (0x8000) to 
+32,767 (0x7FFF). The format is 16 bits wide. 

■ Four Byte Signed 

Four byte integers range from -2,147,483,648 
(0x80000000) to +2,147,483,647 (0x7FFFFFFF). They are 
32 bits wide. 

Unsigned Integers 

Unsigned integers do not use a sign bit. 

■ One Byte Unsigned 

One byte unsigned integer values range from 0 (0x00) to 
255 (OxFF). The format is 8 bits wide. 

■ Two Byte Unsigned 

Two byte unsigned integer values range from 0 (0x0000) to 
65,535 (OxFFFF). The format is 16 bits wide. 

■ Four Byte Unsigned 

Four byte unsigned integers range from 0 (0x00000000) to 
4,294,967,295 (OxFFFFFFFF). The format is 32 bits wide. 

Microsoft Floating Point 

Microsoft floating point numbers' range is 1.7E+38 to 2.9E-39. 

■ Four Byte Floating Point 

The bias of the exponent is 128 and the mantissa is 
normalized to between .1 and .2. A zero is represented by 
an exponent of all zeros (the other bytes don't matter). The 
format is: 


nirmn iirmni iiiiiiiii iiiiiiiii 


8 Bit I Sign Bit: ^ Fractional part, (mantissa) normalized to .IXXX 

Exponent: 1 = negative ("•" implied ahead of most significant bit (which 

excess 128 0 = positive is not stored because it is always 1) 

format. i-©-, mantissa uses 24 bits, only 23 are stored. 
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■ Eight Byte Floating Point 

These have the same range as the 4-byte numbers, but 8- 
byte format's accuracy is 15 decimal places. The format is; 


63 56 55 


0 


iTinim rmnm iir:::in nmnn 


8 Bit 

Exponent: 
excess 128 
format. 


I'-^-' 

'-Sign Bit: Fractional part, (mantissa) normalized to .IXXX 

1 = negative ("•" implied ahead of most significant bit (which 

0 = positive is not stored because it is always 1) 

i.e., mantissa uses 56 bits, only 55 are stored. 


Note that the only difference between the 32 bit and the 64 
bit format is the number of bits allocated to the mantissa. 


IEEE Floating Point 

■ Four Byte Floating Point 

Four byte IEEE floating point numbers range from about 
3.4E-38 to 3.4E+38. The format of this 32 bit number has 
three fields: I sign bit, an 8 bit biased exponent, and a 23 bit 
mantissa. The bias of the exponent is 127 and the mantissa 
is normalized to between 1 and less than 2. The format is: 


31 

m 


n 


24 23 

m nmn 




JL 


16 15 

□mi 


7 

HE 


0 

nrn 


Exponent: excess 
127 format. 




■ Sign Bit: 1 * negative, 
0 = positive 


Fractional part, (mantissa) normalized to 1.XXX 
(’*.’* implied ahead of most significant bit (which 
is not stored because it is always 1) 
i.e., mantissa uses 24 bits, only 23 are stored. 


■ Eight Byte Floating Point 

Eight byte IEEE floating point numbers range from about 
1.7E-307 to 1.7E+308. The format of the 64 bit number has 
three fields: I sign bit, an 11 bit biased exponent, and a 52 
bit mantissa. The bias of the exponent is 1023. It looks like: 


63 55 51 


.Ill 111II1111 cn. 



_II_ 

11 Bit Exponent: 

excess 

1023 format. 


Sign Bit: 1 = negative, 
0 = positive 


0 

::::n 3 iiiiiii u 

— - ' 

^ Fractional part, (mantissa) normalized to 1.XXX 
("." implied ahead of most significant bit (which 
is not stored because it is always 1) 
i.e., mantissa uses 53 bits, only 52 are stored. 
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Packed BCD 

For packed BCD (Binary Coded Decimal) each digit is stored in a 
4 bit nibble (half a byte). Binary numbers 0000 to 1001 
represent the digits 0 to 9. Digits are "packed," 2 per byte, for a 
number of any length. BCD usually represents an even number 
of digits, but the most significant digit can be discarded. BCD 
does not have a decimal point, but can imply one. The format is: 


4 3 2 1 


mum 


LMore digits 
as needed 


7 6 5 4 3 2 1 0 


Digit 

Bit 


Unpacked BCD 

BCD may also be unpacked, with only one digit per byte. This is 
not as commonly as packed BCD (it wastes storage). Number 
representations are the same as packed BCD, but the high four 
bits in each byte are not used. The format is: 

2 1 Digit 


l-More digits 
as needed 


7 6 5 4 3 2 1 0 Bit 

I——I I__-J 

t— Digit stored 
one per byte 

-These bits unused 


Comp3 

CompB (also known as packed decimal), has the same format as 
packed BCD, except that CompB uses the least significant nibble 
to represent a sign bit. The format of a CompB number is: 


3 2 1 Digit 

[in] om [HI] mi] 


L More digits 
as needed 



First digit 
stored as 
in BCD 


Bit 


1 1 


Sign Bit: 

OxOc = positive 
OxOd = negative 
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Zoned Decimal 

Zoned decimal stores values for each digit in EBCDIC, one digit 
per byte. The least significant digit is modified on negative 
numbers by mapping the EBCDIC codes as shown below. 


Digit 

EBCDIC 

Becomes 

0 

OxFO 

OxDO 

I 

OxFl 

OxDl 

2 

0xF2 

0xD2 

3 

0xF3 

0xD3 

4 

0xF4 

0xD4 

5 

0xF5 

0xD5 

6 

0xF6 

0xD6 

7 

0xF7 

0xD7 

8 

0xF8 

0xD8 

9 

0xF9 

0xD9 


For example, -25 would be coded as 0xF2D5. 
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Installation and Configuration 

This chapter describes installation and configuration procedures 
for Overland Data's 9-track controllers; TX-8, XL/2 and TXi-16. All 
models use programmed I/O instead of DMA for data transfer. 

The TX-8 and XL/2 both have 64kB on-board cache buffers, the 
TXi-l 6 has a 1 MB cache buffer. The TXi-16 improves 
performance by using 16-bit I/O. The DOS software uses 
loadable drivers (set during installation) making it device 
independent. 


The following notice applies to all Overland Data tape drive 
controller cards; the TX-8, TXi-16 and XL/2 . /Ml have been 
tested and meet the standards set for Class A computing 
equipment. _ 

WARNING — This equipment generates, uses and can 
radiate radio frequency energy and if not installed 
and used in accordance with the instruction manual, 
may cause interference to radio communications. It 
has been tested and found to comply with the limits 
for a Class A computing device pursuant to Subpart J 
of Part 15 of the FCC Rules, which are designed to 
provide reasonable protection against such 
interference when operated in a commercial 
environment. Operation of this equipment in a 
residential area is likely to cause interference in which 
case the user at his own expense will be required to 
take whatever measures may be required to correct 
the interference. 
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Controller Model TX-8 

This describes the TX-8 and its installation procedures. Read it 
and make sure you have everything in the checklist, the PC 
system documentation, that your card is correctly configured, 
and that you understand the procedures before installation. 

Standard Features 

The standard TX-8 features are: 

■ 64kB cache buffer. 

- Switch selectable I/O address (8 contiguous ports required). 

■ Modes: GCR, PE and NRZI. 

■ Densities: 800, 1600, 3200, and 6250 bytes per inch (bpi). 

■ Compatible with most Cipher/Pertec formatted tape drives. 

■ Burst transfer rate: 900kB/s. Sustained rate: 632kB/s. 
System throughput depends on the PC, program, tape 
condition and hard disk attributes). 

Inventory Checklist 

Check that your TX-8 package includes the following: 

■ TX-8 circuit board and bracket. 

■ One round, shielded cable. 

■ One "P"-clip for cable grounding at the drive. 

■ 5' /4 inch or 3' /2 inch disks (the number of disks varies) . 

Related Information 

Some familiarity with DOS and computer hardware is assumed. 
Operating system commands and I/O port designations assume 
a single-user, single tasking version of MS-DOS. 

System Requirements 

/\ny IBM PC, XT, AT or fully compatible machine (i.e., COMPAQ 
portable and 386, and the Tandy PC line) under MS-DOS. 

The supplied software requires a minimum of 512kB of RAM. 

No DMA channel is required for operation. 

Be sure the MS-DOS system option verify mode is off when 
using the DOS device driver. 

The DOS Device Driver (Options Manual) is NOT required to use 
the DOS programs provided with the controller. Installed, the 
driver uses memory; do not install it unless you plan to access 
the tape system using your own software. 
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Hardware Installation 
Remove the System Cover 

Turn off and unplug the computer and all peripherals. 

Move your keyboard and all external options away from the 
work area. Place the PC in a position so you can work at its 
back. 

Remove all cover mounting screws (counterclockwise). Be sure 
to save all screws for the cover replacement. 

Move to the front of the PC. Slide the cover to the front. When 
the cover will go no further, tilt it up, remove it, and set it aside. 



Look at your computer's inside left rear. The PC has five slots 
and the XT and AT have eight. Do not install the adapter in the 
short slots in the XT. In an AT, use a 16-bit slot if possible. 

If you are installing the TX-8 in an 8 bit slot (PC, XT or AT) you 
must configure the controller as follows: 

■ If you plan to use hardware interrupts, you must physically 
change the IRQ jumper from 10 to 3, 4, 5, 6 or 7. 

■ The 16-bit (small) connector does not have to be in a 
motherboard connector for the TX-8 to work. 

■ If you install the TX-8 in an 8-bit slot, it is important that the 
16-bit connector does not touch (and short out on) 
anything! 

■ The extra connector is for extended AT interrupts only. 
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Remove the screw that holds the expansion slot cover in place. 
Turn counterclockwise to loosen the screw. Be sure you save the 
screw; it will be used to install the product later. 



Removing the empty slot cover 

Check the DIP Switch Settings 

Hold the TX-8 with the component side facing you, gold card- 
edge connector down. The DIP switch is the upper right corner. 
Check that the settings of the eight switches are as shown. 


The appearance of the red dots on 
the rocker switches indicates that that 
side of the switch is inactivated. In the 
example above, switches 1,4,7 and 8 
are ON, so the red dots are UP on the 
OFF side of the switches. 

If you know of an I/O address conflict between the TX-8 and 
another adapter in your system, see the table below to select a 
new I/O base address, and reset the DIP switches before 
continuing with the installation. You can change the I/O base 
port on a TX-8 controller without running config if the new 
base port you select appears in the table following. 



Switch 


Setting 

1 


ON 

2 


OFF 

3 


OFF 

4 


ON 

5 


OFF 

6 


OFF 

7 


ON 

8 


ON 


16 
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DIP Switch 

1 

2 

3 

WEM 

5 

6 

mm 

8 

Address Line 

AlO 

A9 

A8 

A7 

A6 

A5 

A4 

/\3 

360 (defauit) 

ON 

OFF 

OFF 

ON 

OFF 

OFF 

|wuyi 

ON 

300 

ON 

OFF 

OFF 

ON 

ON 

ON 

ON 

ON 

310 

ON 

OFF 

OFF 

ON 


ON 

OFF 

ON 

320 

ON 

[OFF 

OFF 

ON 

ON 

OFF 

ON 

ON 

330 

ON 

pF?] 

OFF 

Op 

ON 

OFF 

OFF 

ON 

340 

“on 

pFFj 

OFF 

“oTTj 

Io'ff 

on” 

ON 

on“ 

350 

ON 

rOFFj 

^OFF 

ON 

OFF 

ON 

OFF 

ON 

Set the DIP switch, anc 

I/O base port is reset. 

So long as t 

he 


address selected is in this table, no reconfiguration is required. 

If the address is not in this range, you must run config on 
each utility you plan to use. 

Unlisted base port addresses require you to set the correct DIP 
switches and run config. 


Note the new address for reference during configuration. 


Install the TX-8 


Press the TX-8 into the expansion slot. Put the non-connector 
end into the card guide. Align the slot in the bracket with the 
hole in the rear computer panel (see below). Replace the screw. 



Aligning the TX-8 retaining bracket 

Install the Cable 

Plug the single, "D"-type connector on the TX-8s connector at 
the back of the PC. Secure the connector by tightening both 
screws. 


Reinstall the System Cover 

Replace the cover. Slide it toward the rear of the computer. 
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When the cover is all the way to the rear, align the cover screws 
and threaded tabs. Tighten screws (clockwise) with a 
screwdriver. 



Connect the Cable to the Tape Drive 

Follow these steps to properly connect the cable to the tape 

drive; 

1. Locate the drive connectors; On the rear of the drive locate 
two card edge connectors that match the split end of the 
cable. 

2. Identify drive connectors Pi/J1 and P2/J2; These connectors 
are normally labeled, on some drives they have different 
names. The lower number connector corresponds to PI and 
the higher one to P2. On drives with two sets of connectors, 
use either set (refer to your tape drive manual for more 
detail). 

3. Identify the pin I end; each connector has pins, numbered 1 
through 50. On some drives the chassis identifies the pin 1 
end of the connector; on others you must check the 
connector. 

Close inspection reveals a number silk screened on the board 
or formed in copper. Finding a 1 or a 2 shows the pin 1 end. 

4. Connect the cable; the cable splits at the drive end. 
Connectors are labeled J1 and J2. The pin 1 end of each is 
marked "I". Press J1 into the PI connector. Press J2 into 
the P2 connector. 
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Grounding 

The drive must be grounded to meet FCC requirements. Place 
the "P"-clip around the cable where the silver mesh is exposed. 
Now use a Phillips screwdriver to screw the P-clamp to the drive, 
just above the PI and P2 connectors. This grounds the cable 
and keeps the cable from accidentally pulling out of the drive. 



Installing the software is easy. Make sure that all your cables 
and peripherals are reconnected. Now turn on your PC and 
tape drive. 

Make a "working" copy of the disks: Turn on your PC and tape 
subsystem. Follow the procedure in the DOS manual for 
copying a disk. Use the diskcopy command. 

If you look at the files on disk, you will not see many. The files are 
compressed— do not copy the files from the disk to your 
hard disk! Instead, insert disk #1 . Move to the drive that the 
disk is in. Now type install, and the install program will 
automatically decompress the files and install them on your 
hard disk. There will be prompts, asking you what directory to 
use, or asking you to insert a disk. 

When this is complete, run conf ig and then test the system. 

TX-8 Configuration 

Changes are made to the TX-8 configuration using a supplied 
program, config. config makes changes (patches) to the 
ODi .RLE file, including the configuration parameters you 
supply. The changes remain until they are changed again. In 
addition, two of the parameters (base I/O port and interrupt 
level) require changing settings on the TX-8. 

19 



Chapter 2—Installing and Configuring Your 9-Track Tape Subsystem 


The following parameters are configurable for the TX-8: 

■ The I/O port used as the controllers base address. 

■ Drive Type: Start/Stop or Streaming. 

■ The J2-50 Speed/Density select line. 

■ The Interrupt level used by the controller. 

■ The Tape Drive address. 

Before proceeding, refer to your notes on address selection. If 
you did not change the switch settings, the address is 360.' If 
you changed the settings, determine the value. 

The CONFIG Program 

The config program must be run for the odi . rlb file. 

To invoke CONFIG, type: C:\> config from the command 
prompt followed by (return) . A message similar to the one 
below will appear on the screen: 

UTILITY CONFIGURATION PROGRAM 
Vers 1.8 8/23/85 (c) 1985 OVERLAND DATA, INC. 

Enter filename<cr> to configure or <cr> to quit, 
filename —> 

Type ODI .RLB (ENTER) . CONFIG Will display: 

Configure Tape Controller 

Enter new value<cr> to set new value, or <cr> to leave value unchangeci. 

CONFIG searches the target files for the configuration data and 
displays the current values: 

Item to change: Current Value: 


Base Port 

The TX-8 requires eight contiguous I/O ports. This configuration 
parameter specifies the first (lowest) address in the selected 
address range. With an address of 360 (hex) (factory default), 
the controller will occupy I/O addresses 360 (hex) to 367 (hex). 
You can change the I/O base port on a TX-8 controller without 
using config if the new base port you select is listed below. 


DIP Switch 

1 

2 

3 

4 

5 

6 

7 

8 

Address Line 

AlO 

A9 

A8 

A7 

A6 

A5 

A4 

A3 


ON 

OFF 

OFF 

ON 

OFF 

OFF 

ON 

ON 

300 

ON 

OFF 

OFF 

ON 

ON 

ON 

ON 

ON 

310 

ON 

OFF 

OFF 

ON 

ON 

ON 

OFF 

ON 

320 

ON 

OFF i 

! Off 

ON 

ON 

OFF 

ON 

ON 

330 

ON 

1 OFF 1 

[ OFF 

ON 

ON 

OFF 

OFF 

['on" 

340 

ON 

OFF 

1 OFF 

ON 

OFF 

ON 

ON 

! ON 

350 

ON 

1 OFF 

OFF 

ON 

OFF 

i ON 

OFF 

i ON 
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Set the DIP switch (in the board's upper right corner) as shown, 
and the I/O base port reconfiguration is complete. Normally, 
the software running with the controller would also have be 
reconfigured, but the supplied utility programs (as well as mto 
and alltape) include an automatic configuration routine which 
looks for the TX-8 controller at each listed address in turn, and 
configures accordingly if the board is found. 

The auto-configure feature is activated by selecting a base I/O 
address of 0 in config (this is the factory default). 

Unlisted base port addresses require you to determine the DIP 
switch settings, change the switches, and run config. 

GDI Controller Address (0 for PS2): = 0000 (base 16) 

New Value: 

Drive Type 

Older model Start/Stop drives require programs to wait until 
the Formatter Busy signal goes false before issuing new 
commands. By default, the utility package does not do this. If 
you have a Start/Stop drive, and xtest returns block size 
errors, then you may need to change this configuration 
parameter. 

It is hard to predict every configuration incompatibility 
symptom. We suggest you run xtest using the standard 
configuration. If xtest reports problems, check the board 
installation, cable connection and hardware configuration. If 
these are correct, then check the configuration parameters for 
possible conflicts. 

START/STOP DRIVE(1), NORMAL(0) = 0 (base 10) 

New Value: 

J2-50 Speed/Density Select Line 

This typically controls speed selection in a dual-speed drive. Our 
software uses this to dynamically control speed (seeks use 
higher speed). If your drive uses this as a density select line 
(older drives may), the program won't work (you may see data 
compare errors). To fix the conflict, check the drive manual, and 
set density selection to local control. If this is not possible, use 
CONFIG to set this line to LOW (value 1) or HIGH (value 2). 

J2-50, Normal (0), LOW(l), HIGH (2) = 0 (base 10) 

New Value: 
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Interrupt Level 

A source of interrupts is needed for the TX-8. The table below 
lists available interrupts in a PC-AT. The jumper can be set for 
any one of the IRQ levels. 

The TX-8 default is IRQ 0 (the PC's timer tick); this interrupt 
doesn't use a jumper. The board is shipped jumpered for IRQ 10. 
This doesn't cause a conflict. When IRQ 0 is selected, any jumper 
on the header pins is ignored. To reconfigure from IRQ 0 to IRQ 
10, you don't need to remove the controller to move the 
jumper. 


1 IRQ Level 


Possible System Conflict 


NQ (default) 

Multitasking DQS or TSR 


Yes 

COM 2 

4 

Yes 

COM i 

5 

Yes 

Parallel Port 2 

6 

Yes 

Floppy Disk Controller 

7 

Yes 

Parallel Port 1 

9 

_Yes_ 

Software redirects to IRQ2 

io 

Yes (default position) 


i i 

Yes 


■■inMiH 

Yes 



_^s_ 

Hard Disk Controller 


Yes 



Note: In PC-XTs, interrupt levels 9 through 15 are not available. 
To reconfigure the interrupt, remove the board and locate 
header pins marked 3 to 1 5 (for boards marked with A to M, 
see ''TX-8 Interrupts" in Appendix A) on the lower edge of the 
board . Move the shunt jumper to the pair of pins 
corresponding to the new interrupt level, reinstall the board 
and reconfigure the software. 

Interrupt Level (0=timer tick): = 0 (base 10) 

New Value: 


Tape Drive Address 

A 9-track tape drive is accessed with a unit address from 0 to 7. 
The address can be determined and changed (consult your drive 
manual); most systems with a single drive address it as unit 0. 
The tape drive address is configured using config (described 
below). Addresses 0 through 7 are supported. 

If you made no changes to the values, config will display: 
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No change was made to the configuration. 

Do you wish to change any of these values? (y,n): 

If you make a change, config displays the new values and then 
asks if you want to make further changes: 

Do you wish to change any of these values? (y,n): 

Continue making changes, or make changes to more files; 

Do you wish to configure another file? (y,n): 

If you answer Yes, config repeats the configuration process. A 
No reply will return you to DOS. 

Drive address (0-7): = 0 (base 10) 

New Value: 

Test the Complete System 

The following steps outline the procedure to test your personal 
computer tape subsystem. This procedure will write to tape 
(writing over any data already on the tape!), so be sure the 
tape you choose has nothing important on it. 

1. Load a tape onto the drive: Use a scratch tape with a write 
enable ring. See your drive manual for the procedure. 

When the tape is loaded, place the drive online. 

2. Execute xtest to perform the following three tests: 

■ Status Test. This makes sure that the drive is ONLINE, not 
FILE PROTECTED, and that cables are properly connected. 

■ On-board Cache Test. This test assures the integrity of the 
TX-8 cache memory. 

■ Tape ReadAX/rite Test. This tests the subsystem's ability to 
write data, write filemarks, read data, read filemarks, and 
rewind. On completion of these tasks, xtest will display: 

All tests successful. 

in the Status Window. 

For any other xtest outcome, check that the TX-8 is installed 
and configured correctly, that the cables are properly 
connected to the drive, that the drive is ONLINE and not FILE 
PROTECTED. 

After successful completion of xtest you are ready to proceed 
with any of the tape applications. 
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Controller Model TX/-16 

This section describes the TXi-l6 controller and its installation and 
configuration procedures. Before installing the card in your 
computer, read the entire TXi-l 6 section. Be sure you have all 
parts in the checklist and that you have the recommended 
system documentation. 

Standard Features 

The standard TXi-l6 features are; 

■ I MB cache buffer. 

■ Configuration data is stored in NOVRAM (non-volatile RAM). 

■ Supports GCR, PE, and NRZI densities. 

■ On-board microprocessor. 

■ 16-bit architecture. 

■ Densities: 800, 1600, 3200, and 6250 bytes per inch (bpi) 

■ Compatible with most Cipher/Pertec formatted tape drives 

■ Burst rate: 2 MB/s. Sustained transfer rate: 1.3 MB/s. 
Throughput depends on the computer, the program, the 
condition of the tape, and attributes of the hard disk. 

Inventory Checklist 

Check that your TXi-l 6 package includes the following: 

■ TXi-l 6 circuit board and bracket 

■ One round, shielded cable 

■ TXi-l 6 configuration tool (plastic rod) 

■ One "P"-clip for cable grounding 

■ Distribution software on either S'AH’nch or 3'/ 2 -inch disks. 

Related Reading 

This manual assumes some familiarity with MS-DOS and IBM 
PC/XT/AT hardware. References to operating system commands 
and I/O port designations in this manual assume operation 
under a single-user, single tasking version of MS-DOS. 

The TXi-l 6 works with all IBM ATs and 100% compatibles, (i.e., 
the COMPAO 286/386/486, the EVEREX "STEP" series). 

The supplied software requires a minimum of 5l 2 kB of R/MVl. 

No DMA channel is required for operation. 
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Hardware Installation 
Remove the System Cover 

Turn off and unplug the computer and all peripherals (note 
cable connections so that you can replace them later). 

Move your keyboard and peripherals away from the work area. 
Place the PC in a position so you can work at its rear. 

Remove all cover mounting screws (counterclockwise). Be sure 
to save all screws for the cover replacement. 

Move to the front of the PC. Slide the cover to the front. When 
the cover will go no further, tilt it up, remove it, and set it aside. 



Removing the system cover 


Select an Open Card Slot 

Look at the inside left rear of your computer. The TXi-16 must be 
inse rted into a 16-bit slot (one long and one short connecto r). 

The TXi-16 must be inserted into a 16-bit slot 
(one long and one short connector). 

The board will not operate in an 8-bit slot. 

Remove the screw that holds the expansion slot cover in place. 
Turn counterclockwise to loosen the screw. Be sure you save the 
screw; it will be used to install the product later. 
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Removing the empty slot cover 

Install the TXi-16 

Hold the top of the TXi-16 and press it into the slot. The non¬ 
connector end should be in the vertical card guide as the TXi-16 
is put into the computer. Align the board's retaining bracket 
slot with the hole in your computer's rear panel (below). 
Replace the screw, and tighten clockwise. Installation is done. 


a 


Not Aligned 


Aligned 



Aligning the TXi-16 retaining bracket 

Install the Cable 

Plug the single, "□"-type connector onto the TXi-l 6's connector 
at the back of the computer. Secure by tightening both 
connector screws. 


Reinstall the System Cover 

Replace the cover by putting it in a position as shown. Carefully 
slide it toward the rear of the computer. 

When the cover is all the way to the rear, align the cover screws 
with the threaded tabs. Use a screwdriver and turn the screws 
clockwise to tighten them. 
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Follow these steps to properly connect the cable to the drive: 

1. Locate the drive connectors: Check the rear of the tape 
drive and locate two card edge connectors that match 
those on the split end of the TX-8 cable. 

2. Identify drive connectors PI/J1 and P2/J2: These connectors 
are normally labeled, on some drives they have different 
names. The lower number connector corresponds to PI and 
the higher one to P2. On drives with two sets of connectors, 
use either set (refer to your drive manual for more detail). 

3. Identify the pin 1 end: each connector has pins, numbered 1 
to 50. On some drives the chassis identifies the pin 1 end of 
the connector; on others you must check the connector. 
Close inspection reveals a number silk screened on the board 
or formed in copper. Finding a 1 or a 2 shows the pin I end. 

4. Identify and connect the cables: the cable splits at the drive 
end. The connectors are labeled J1 andJ2. The pin 1 end of 
each ts rrarked with a 1. Press J1 into the PI connector. 
Press J2 into the P2 connector. 

Grounding 

The drive must be grounded to meet FCC requirements. Place 

the "P"-clip around the cable where the silver mesh is exposed. 

Now use a Phillips screwdriver to screw the P-ctamp to the drive, 

just above the PI and P2 connectors. This grounds the cable 

and keeps the cable from pulling loose from the drive. 


27 























Chapter 2—Installing and Configuring Your 9-Track Tape Subsystem 



Installing the software is simple. Make sure that all your cables 
and peripherals are reconnected. Now turn on your PC and 
drive. 

Make a "working" copy of the disks: Turn on your PC and tape 
subsystem. Follow the procedure in the DOS manual for 
copying a disk. Use the diskcopy or the copy command. 

If you look at the files on disk, you will not see very many. Most 
files are compressed, so do not copy the files from the disk 
to your hard disk! Instead, insert Disk #1 and type: 
INSTALL, and the install program will automatically decompress 
the files and install them on your hard disk. There will be 
prompts, asking you what directory to use, or asking you to 
insert another disk. 

When installation is complete, run the txisetup program from 
your hard disk (see below) and then test the system. 

TXf-16 Configuration 

Note: If there is an I/O address conflict between the TXi-l 6 and 
another card in your system, see TXISETUP (this chapter); 
program the card for a new I/O address, and patch the 
device drivers with it. Finish installing the card and software. 
Then complete the TXISETUP configuration. Once the card and 
software are reconfigured, return to this section to test it. 

Configuration Procedure 

TXISETUP configures the NOVRAM for proper I/O address and 
drive type. Run config on the odi .rlb. Before starting 
configuration, be sure these tasks have been performed: 
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1. The Overland Data software must be installed in a directory 
on your hard disk. 

2. The ODi= environment variable must contain a path to the 

above directory. To verily that the ODI environment variable 
exists, type: set (return) . 

This lists the environment variables. If the ODI variable does 
not exist, the tape utility programs can only be used from 
the current directory. If an ODI environment variable does 
not exist, you must also run txisetup from this directory. 
To set the ODI environment variable, enter; 
set ODI=C:\odiutils 

(or whatever directory name you use) 

This should be added to your DOS path. 

3. ATXi-16 board is physically installed in the system. 

4. The configuration tool, or small screwdriver is available. 

TXi-16 Configuration 

1. Turn the PC's power OFF and move the PC system unit to a 
position where you have access to the front and rear panels. 

2. Locate the TXi-16 bracket on the rear of the computer. 
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3. Locate the configuration switch access hole just below the 
LED on the TXi-16 bracket. 

4. Use the configuration tool or small set screwdriver to 
depress the switch just behind the access hole. You should 
feel the pressure of the spring in the switch as you insert the 
tool into the access hole. Keep the switch depressed. 

5. Turn the power on while keeping the switch depressed. After 
about 2 seconds the LED on the TXi-16 bracket will glow 
both green and red simultaneously (and may appear 
orange).. This means the board recognizes the switch closure 
and is in configuration mode. Release pressure on the switch 
and remove the configuration tool. 

6. Get into the ODI directory, and run txisetup. You should 
see a menu like the one following: 



If an error window is displayed, be sure you are in the ODI 
directory and that the file ODI.RLB is present in the directory. If 
ODI.RLB is not in the directory, you must re-install the software. 
Setting Tape Drive Type and the lO Address 
You can display the current configuration settings by selecting 
Display Configuration and Change the configuration 
settings by selecting Edit configuration. 

To change board I/O address, select Edit configuration, 
then select Change Board I/O Address. Select an address 
from the displayed list, using the arrow keys to highlight your 
choice and pressing (enter) . The TXi-16 requires eight contiguous 
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I/O ports for operation. This configuration parameter specifies 
the first (lowest) address in the selected address range. Thus, 
with an address of 340 (hex), the controller will occupy I/O 
addresses 340 (hex) to 343 (hex). 


I/O Address 

Notes 

340 hex 

310 hex 

310 hex 
320 hex 
330 hex 
350 hex 
360 hex 
3E0 hex 

100 hex 

1 10 hex 
220 hex 
250 hex 
260 hex 
280 hex 
290 hex 
2A0 hex 

DEFAULT SETTING 

i 

[ 

1 

1 

i 

1 


The TXi-1 6 base port is set with txisetup. Once the base port is 
set, the NOVR/WI on the card will remember it until txisetup is 
used to change it. The Your Choice selection allows you to 
specify an I/O address if the listed addresses are not available. 

To change the tape drive type, choose Select a New Drive 
Type. A list of tape drives will appear. It is important to choose 
the drive you are using, since the TXi-16 uses this information to 
optimize performance and speed. Use the arrow keys to 
highlight your choice and press (enter) . This information is used 
by the TXi-l 6 to handle the interface differences some tape 
drives exhibit. If your drive is not on the list, choose pe 
streamer or start/stop Drive depending on which type of 
drive you are using. 
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Selecting Save Configuration prompts you for confirmation; 
you may return to the main menu at this point by selecting 
CANCEL. To save the configuration, select ok. 

8. Once ok has been selected, the prompt: 

SAVING CONFIGURATION... 

appears while txisetup is communicating with the TXi-1 6. 
When the configuration process is complete, txisetup will 
exit and a DOS prompt will appear. 

9. Check that the LED on the rear panel shows green. This 
means the board has accepted the configuration and is 
ready. 

10. Get into the ODI directory, and test the new system 
configuration with xtest. 

11. Turn off the power and arrange the PC for normal use. 

12. Turn on the power and allow the system to boot up. 

13. Since this board stores configuration data in non-volatile 
memory, removal of the PC unit cover is not necessary. 


Test the Complete System 

The following steps outline the procedure to test your personal 
computer tape subsystem. 

1. If you have not done so, backup the software disks: Apply 
power to the computer and tape subsystem. Before testing 
the subsystem, use the procedure outlined in the MS-DOS 
manual for copying a disk. Use the DOS diskcopy or copy 
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command to make backup copies of the supplied software 
disks. 

2. Load a tape onto the drive: Load a scratch, write-enabled 
tape onto the tape drive. See your tape drive Operations 
Manual for the correct loading procedure. 

This procedure will write to tape, so make sure the tape you 
choose has nothing important on it. 

3. Execute the xtest program to perform the following tests: 

■ Status test. This test makes sure that the tape drive is 
ONLINE, not FILE PROTECTED, and that the cables are 
properly connected. 

■ TXi cache is checked at power up. No cache test is 
performed during xtest. 

■ Tape read/write test. This tests the subsystems ability to 
write data, write file marks, read data, read file marks, 
and rewind. Upon successful completion of these tasks, 
XTEST will display the message: 

All tests successful, 
in the status window. 

For any other outcome of xtest, make sure the TXi-1 6 is 
properly installed and configured, that the cables are correctly 
connected to the tape drive, and that the tape drive is ONLINE 
and not FILE PROTECTED. After successful completion of xtest 
you are ready to use the supplied applications. 

After successful completion of xtest you are ready to proceed 
with any of the applications in Chapters 3, 4, 5 or 6. 

TXISPD 

The TXi-16 (via drive selection in TXISETUP) automatically selects 
the highest speed available for your drive. In the event that you 
need to alter that speed, use the TXISPD program. Type: 

TXISPD (ENTER) . 

The program will show: 

Currently cirive speed selection is (the current valid selection). 

1. Allow speed to be selected under program control. 

2. Always use high speed. 

3. Always use low speed. 

4. Do not make any changes. 

Your choice ==> 

You must make a selection (use selection 4 if you simply want to 
escape without making changes) once you enter txispd. 
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SETCARD 

Regardless of which Overland Data controller card you have, 
you use setcard to tell the software which driver to use. The 
default selection is the driver for the TX-8 and XL/2, so for the 
TXi-16 you MUST run this program. 

Type: setcard (enter) 

SETCARD will appear, telling you where the ODI.RLB file was 
found, what controller is presently selected and what drivers 
are available in your ODI.RLB file: 

Found "ODI.RLB" in directory: 

C:\ODI 

SETCARD MENU: 

Drivers available are: 

1 "TX8_XL/2" « PRESENTLY SELECTED » 

2 "TXi" 

type a number between 1 and 2 (or ESC to exit). —> 

If you find that you do not need to change the present setting, 
press (esc) now. 

If you do need to select a new setting, press the number for the 
correct driver, setcard will ask you to confirm the selection. 
Press Y (yes) and (enter) to confirm, or N (no) and (enter) to 
abort the change. 
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Controller Model XL/2 

This section describes the XU2 controller installation and 
configuration procedures. Before installing the card in your PC, 
read the entire XL/2 section. Be sure that you have all parts in 
the checklist, that you have the recommended system 
documentation, and that you understand the procedure. 

Standard Features 

The standard XLy2 features are; 

■ Automatic configuration. 

■ Full hardware support of PS/2 Programmable Option Select. 

■ Supports GCR, PE, and NRZI densities. 

■ Densities: 800, 1600, 3200, and 6250 bytes per inch (bpi). 

■ Compatible with most Cipher/Pertec formatted tape drives. 

■ Burst data transfer rate: 900kB/s. Sustained data transfer 
rate; 632kB/s. System throughput will depend on the 
computer, the program, the condition of the tape, and 
attributes of the hard disk. 

Inventory Checklist 

Check that your XLy2 package includes the following; 

■ XLy2 circuit board assembly 

■ One round, shielded cable 

■ One "P'-clip for cable grounding 

■ Distribution software on a 3'/^-inch diskette 

Related Reading 

This manual assumes some familiarity with MS-DOS and the IBM 
PS/2 hardware. /Ml references to operating system commands 
and I/O port designations in this manual assume operation 
under a single-user, single tasking version of the DOS operating 
system (OS/2 is not supported). 

System Requirements 

The XL/2 works with any IBM PS/2 with the Micro Channel 
/Vchitecture expansion bus. (this includes Models 50, 60, 70, 75, 

80 and future models with the Micro Channel Architecture bus.) 

The supplied software requires a minimum of 512kB of RAM. 

No DMA is required. 

A copy of the IBM Reference disk is required to configure the 
XL/2 when it is installed. 
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Hardware Installation 
Remove the System Cover 

Locate the section in the IBM Quick Reference booklet that 
explains how to remove the system unit cover. 

1. Turn off and unplug the computer and all peripherals (note 
the location of all cables and cords for reconnection later). 

3. Check that the cover lock is unlocked. 

4. Loosen the cover screws. If they are too tight, use a coin. 

5. Remove the cover by sliding it forward approximately 2 
inches and lifting it. 

Install the Xiyz 

Locate the section in the IBM Quick Reference booklet that 
explains how to install an adapter. 

1. Locate an open expansion slot. 

2. Remove the expansion slot cover. To do this, loosen the 
screw (you can use a coin) and remove the expansion slot 
cover. 

3. Install the adapter by pressing it into the expansion slot until 
the adapter clicks into place. Then tighten the screw. 

Reinstall the System Cover 

Locate the section in the IBM Quick Reference booklet that 
explains how to install system unit cover. 

1. Install the cover by placing it over the system unit 
approximately 2 inches from the rear and sliding it on. 

2. Tighten the cover screws. 

3. Connect all cables and cords to the rear of the system unit. 
Then plug all computer power cords into electrical outlets. 

Connect the Cable to the XL/2 

Plug the single "D"-type connector into the XLy2's connector at 
the back of the computer. Tighten both connector screws. 
Connect the Cable to the Tape Drive 
Follow these steps to properly connect the cable to the drive: 

1. Locate the drive connectors. Check the drive to find two 
card edge connectors matching the cable connectors. 

2. Find the drive connectors, PI and P2 (some drives use other 
names, with the lower number being PI and the higher P2). 
For drives with two sets of connectors, use either set. 

3. Identify the pin I end. Each connector has pins, numbered 1 
to 50. Qn some drives the chassis identifies the pin I end of 
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the connector. On others you must examine the connector 
for a number (1 or 2) on the board, indicating the pin 1 end. 
4. Connect the drive end of the cable (it splits in two at the 
drive end). These connectors are J1 andJ2. The pin 1 end of 
each connector shows a 1. Press J1 to the PI connector. 
Attach J2 to the P2 connector. Pin 1 of each cable 
connector attaches to pin 1 of each drive connector. 
Grounding 

The drive must be grounded to meet FCC requirements. Place 
the “P"-clip around the cable where the silver mesh is exposed. 
Use a Phillips screwdriver to screw the 'P"-clamp to the drive, 
above the PI and P2 connectors. This grounds the cable and 
keeps the cable from accidentally pulling loose from the drive. 



XL/2 Configuration Overview 

Configuration of the XLy2 Tape Controller is easy. There are no 
switches to set or jumpers to move. With the card installed in 
the computer, the software on the IBM Reference Diskette, in 
concert with the Automatic Configuration File from Overland 
Data (file @7E7 6 . adf on the UTILITIES disk #2), handles the 
process. 

This section describes the configurable settings. Usually you let 
the Configuration Program automatically select the 
appropriate settings. In some cases you may need to change 
them to solve a configuration conflict or to better match your 
environment. 

The configurable XL/2 options and their default settings are: 
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Option 

Default Setting 

I/O /\ddress 

360 hexadecimal 

interrupt Level 

10 decimal 

Drive /^dress j 

6 

tape Densiity/fape Speed j 

Normal 

start/stop or Streaming | 

Streaming 


Address 

The X\J2 uses 8 contiguous I/O addresses and can be addressed 
to any base address on even boundaries of 8 (0000 to FFF8 
hex). Much of the address space below 400 hex is used by IBM. 
The default address is 360 hex. If this conflicts with another 
device (shown by * next to the selection), make another 
selection. 

Interrupt Level 

The IBM PS/2 has 11 interrupt levels available on the Micro 
Channel bus. This selection allows you to select any one of 
these, or to disable the hardware interrupts. The Overland 
Data software chains into the DOS system clock interrupt (IRO 
8) if the hardware interrupt is disabled. 

The default hardware interrupt level is 10 (decimal). If this 
conflicts with another device, select another interrupt. 

Drive Address 

This selection allows you to specify which drive address the X172 
will select when the unit is first powered on. Normally, you 
should specify drive address 0. 

Tape Density/Tape Speed Select 

Pin number 50 on the J2 connector is used on some drives to 
select either one of two speeds or one of two tape densities. 
Refer to the tape drive documentation for the interpretation of 
this signal by your tape drive. The default setting sets this signal 
to Normal. The XLy2 only supports speed selection—not 
densities. 

Streaming or Start/Stop 

Selecting streaming or start/stop mode alters the commands 
sequence issued by the software to the drive. Streaming is the 
normal choice (for streaming tape drives). Some older drives 
have trouble with commands issued before the formatter-busy 
(IFBSY) line indicates that the formatter is not busy. This 
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problem sometimes causes the tape drive to quit functioning 
until it is reset. In these rare cases, try the start/stop setting. 

If you select start/stop on a streaming drive, you may 
experience degraded performance. This will manifest itself as an 
increase in tape repositioning. 

Configuring the PS/2 for the XL/2 

When a new adapter card is installed, the IBM PS/2 detects the 
change in it's hardware configuration. This results in an error 
message and a request for the Reference diskette. As the 
computer goes through it's configuration sequence it uses files 
on the Reference Diskette that tell it how to configure the card, 
if you haven't made a copy of the Reference diskette, do so. 

The steps to configure the PS/2 for the XLy2 are: 

■ Start the working copy of the Reference diskette. 

• Copy the XL/2 configuration file to the Reference disk. 

■ Activate the XL/2 configuration file. 

Start Reference Diskette 

Locate the section in the IBM Quick Reference booklet that 
explains how to start the Reference diskette. 

1. Insert the Reference diskette into drive A. Make sure the 
diskette clicks into place. 

2. If the PC is off, turn it on. If on, press (ctrl) + (7^ + (deQ . then 
release them. This will reboot the system into DOS. 

3. Wait for the Reference disk sign-on message. It will ask if you 
want to run auto-configure. /\nswer no (press n). 

Copy XLy2 Configuration File to Reference Diskette 

1. Select Copy an option diskette from the menu. Wait 
for the prompt for the option diskette to be placed in drive A. 

2. Place the XL/2 UTILITIES disk in drive A and press (return) . 

Wait for the prompt to put Reference diskette in drive A. 

3. Place the Reference diskette in drive A and press (return) . 

Wait until the menu appears. 

Activate XL/2 Configuration File 

1. Select Set Configuration from the Main Menu. 

2. Select Run Automatic Configuration from the Set 
Configuration Menu. Remove the Reference Diskette. 
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3. Press fcr^ . (aIj) and (deD at the same time, then release 
them. This will reboot the system into DOS. 

Installing the Software 

Installation is simple. Make sure that all your cables and 
peripherals are reconnected. Now turn on your PC and drive. 
Make a "working" copy of the disks: Turn on your PC and 
tape subsystem. Follow the procedure in the DOS manual for 
copying a disk. Use the diskcopy command. 

If you look at the files on disk, you will not see many. The files are 
compressed, so do not copy the files from the disk to 
your hard diskI Instead, insert Disk #1 and type install. 

The install program will decompress the files and put them on 
your hard disk, prompting you as needed. 

When installation is done, test the system. 

Test the Complete System 

These steps outline the subsystem test procedure. 

1. Before testing the subsystem, make a backup of the disks— 
follow the procedure in the MS-DOS manual for copying a 
disk. Use the DOS diskcopy command. 

2. Load a tape onto the drive; Load a scratch, write-enabled 
tape onto the tape drive. See your tape drive Operations 
Manual for the correct loading procedure. 

This procedure will write to tape, so make sure the tape you 
choose has nothing important on it. 

3. Execute xtest to perform the following three tests: 

■ Status test. This checks that the tape drive is online, not 
file protected, and that the cables are connected. 

■ On-board cache memory test. This test assures the 
integrity of the XL/2 cache memory. 

■ Tape read/write test. This tests the subsystems ability to 
write data, write file marks, read data, read file marks, 
and rewind. Upon successful completion of these tasks, 
XTEST will display the message; 

All tests successful, 
in the status window. 

For any xtest result, check that the XL/2 is properly installed 
and configured, the cables are correctly connected, that the 
drive is online and not file protected. After successful completion 
of XTEST you are ready to use the supplied applications. 
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9-Track Tape Subsystem Tools 

XTEST tests the integrated TX-8, XU2 or TXi-16 tape subsystem. 

WHAT shows each source module's version in the tape programs. 

XTEST 

XTEST provides a rapid test of the integrated tape subsystem 
with Overland Data's controllers. After installing the controller, 
you should run xtest before attempting to execute any other 
tape utility. Passing the diagnostics indicates that your system 
is correctly installed and the hardware is working properly. 

Features 

XTEST tests the following controller and tape functions: 

■ Status Test 

■ Onboard Cache Test (TX-8 and XLy2 only) 

■ Tape ReadAVrite Test 

Use 

Find a scratch tape, insert a write enable ring in the back of the 
tape reel, and load it onto the tape drive. Put the drive 
ONLINE. 

Note: This procedure will write to tape. Make sure that the 
tape you choose has nothing important written on it. 

Boot DOS and run xtest. xtest displays the following : 
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XTEST performs the three tests listed in the Tests Window. As it 
completes each test, it places a check mark (V) in the 
appropriate box. The Test Status Window displays the status 
messages of each test. If an error occurs, the Test Status 
Window displays the exact error and the Information Window 
gives you trouble shooting guidelines. Be sure to read this 
information carefully before calling Overland Data. Sometimes 
problems with the controller or subsystem are simply incorrect 
cable installation or improper seating of the board. 

The Action Window displays the action (for example, reading 
data, writing data, rewinding tape) of each test. 

Upon successful completion of its tests, xtest displays the 
following screen: 


Uersinn A .GQ XI K S 1 ^^✓I1 mzeWWJh 



-[ Press ESC to exit progran ] 
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WHAT 

Use WHAT to determine what source code modules were used to 
create your Overland tape software utility programs. This 
information is useful to Overland Data's software support in 
identifying and resolving any software problems. 

Use 

To use WHAT, type what at the DOS command line followed by 
the full file name of each program that you want source version 
information for. what recognizes the DOS wildcard characters * 
(matches any file name part) and ? (matches any single 
character). 

For example, to display source version information for utility 
programs xtest and config, type: 


C:\> what 

xtest.exe 

config.exe 

XTEST.EXE: 



xtest.c 

00 

1 

6/11/88 

alltape.c 

1.8 - 

6/10/88 

CONFIG.EXE: 



config.c 

1.8 - 

8/23/88 


Note that we specified the complete file name for each program 

(that is, XTEST.EXE, nOtjUSt XTEST ). 

The version number and date indicate which software modules 
you have. We can determine if you have the newest release. 

To display source version information for all of the Overland 
utility programs, type; 

C:\> what *.exe 

Since * matches any file name part, *. exe will match all 
programs with extension exe. 

Limitations 

WHAT only works with software from Overland Data Inc. 
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Tape Applications 

The Tape Applications are a set of tools designed to optimize 
your PC's 9-track tape subsystem. This chapter describes the 
utilities for testing, data interchange and configuration. 

Chapter 6 describes the programming interface, txisetup 
and CONFIG let you configure parameters (dependent on the 
controller) and make these parameters consistent for the Tape 
Utilities. They are in Chapter 2, Installation and Configuration. 

Note: We keep our manuals up-to-date, but last-minute releases 

may modify information in this manual. Refer to any addenda included 
with the manual, and read the readme.doc file on the release disk 
before using the utilities. __ 

For data interchange. Overland Data provides: 

. depot (Data Exchange Program with Optional Translation) 
lets you to read or write tapes; and allows conversion 
between ASCII and EBCDIC. You may also append data to 
existing tapes and read from an arbitrary tape location. 

• DEPOT2 allows command line execution (for convenient 
batching) and automatic insertion of Carriage Return Line 
Feed (CRLF) delimiters after each record read. 

. DEPOTS is the most flexible data conversion utility for 
reading tapes. By using a script file, you can define different 
translation criteria at the field (byte) level for each record. 

FDUMP lets you quickly examine data blocks from a 9-track tape. 

LABEL is a step-by-step menu driven utility, allowing you to 
create IBM or ANSI Standard labeled tapes. 

TAPEUTL provides normal handling of labeled and unlabeled 
tapes. 

TDE is designed to extract data from tape files and transfer it to 
a PC file. The data is extracted file-by-file from tapes with fixed 
length records, with various types of conversions being possible. 

TAR is a backup application. It also provides data interchange 
capabilities with XENIX and UNIX systems. 
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DEPOT4 

DEPOT4 ties together some of our most popular programs: 

FLASHBAK, (a Separate option); depot2, see page 60; fdxjmp, 
see page 84; label, see page 92; tar, see page 175, and 
NOVELL TAR (an Optional Novell backup/restore version of 
tar). This lets you operate any of these utilities from a single, 
easy-to-use program. From depot4, with the standard 
software package, you can: 

■ Read labeled or unlabeled tapes 

■ Write labeled or unlabeled tapes 

■ View the contents of any tape on your display 

■ Back up or restore your DOS filesystem 

■ Read or write UNIX / XENIX tar tapes 

You don't need to be a 9-track expert to use depot4. The 
program provides on-screen explanation and help as long as 
you are within the program. 

In DEPOT4, you can back up or escape by pressing (1^ . 

Before you can use depot4, you must complete installation of 
the Overland Data utilities. See the instructions in Chapter 2. 

Setup 

DEPOT4 uses the DOS environment to locate the directory 
containing the Overland Data utility programs. This allows you 
to run DEPOT4 from any sub-directory in your disk system. 

For DEPOT4 to function, when you put your Overland Data 
utility programs on your hard disk, you must install them in a 
sub-directory of their own, such as c: \odiutils . 

With the utilities installed (using the directory example above), 
enter the DOS command: 

set: ODI=C:\odiutils 

(or whatever directory name you use) 

This variable allows depot4 to locate the other Overland Data 
utilities—^without it, depot4 will not work. To avoid entering 
this each time you boot up, add set ODi=C:odiutils to 
the DOS path in your autoexec.bat file. You can add the 
pathname for the Overland Data utilities to your DOS path in 
your autoexec.bat file, ensuring that this environment 
variable is set when you boot up your PC.. depot4 is ready to 
go to work. 
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Using DEPOT4 

Using depot4 is easy. Each step of the way, depot4 explains 
what you are doing and how to set up for the next step. If you 
make an error or change your mind, simply (ub) to the data to 
change it or press (H© to back up until you can start again or 
escape depot4. 

Starting DEPQT4 

If you placed the name of the directory containing the Overland 
Data utilities in your DOS PATH, then simply type: 

depot4 (ENTER) 

at the DOS prompt. If you have not modified your path, use 
the full path name (using our example from above): 
C:\ODiuTiLS\DEPOT4 to execute the program. 

The DEPOT4 Screen 

When you start depot4 you see two areas, labeled Main 
Menu and Full Time Help. The Main Menu consists Of a list 
of selections, one of which is highlighted. We will refer to the 
highlighted cursor as the Select Bar. The Full Time Help 
window is always active, and contains a brief description of the 
item that the Select Bar is currently on. 

Menus 

DEPOT4 is a menu based program. Learning to "navigate' and 
select menu items is the first easy step in mastering depot4. 
You need to learn to: 

Move between menu items. 

Select menu items or options. 

The arrow keys (© and ©) are used to move from one menu 
item to another. The © moves the Select Bar down one entry. 
The © moves the Select Bar up one entry. To move the first 
item in any given menu, press (home) . To move instantly to the 
last item in a menu list, press the (Ind) . An alternative to using 
the arrow keys to move between menu items is fx^ . Use (1^ 
to move the Select Bar down one entry and ( shift) + fT^ to 
move up one entry. 

Hint: the last item in many menus is Execute. To begin the 
tape operation, press (Ind) to get to Execute immediately. 


To select menu items press (enter) or ( ) (space bar). 
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Any individual item in a menu can also be selected by pressing 
the key corresponding to the highlighted character in the item. 
You can always change your mind while in the depot4 
program. Pressing fisc) will exit from any menu or dialog box. 
From the main menu, pressing fisc) is the same as selecting the 
Quit option, and you will be asked if you wish to exit the 
program. Selecting yes will leave the program and bring you 
back to DOS. Selecting no brings you back to the main menu. 
Dialog Boxes 

Dialog boxes pop up in response to certain menu selections, 
allowing you to enter filenames or numbers. You may edit the 
filename or number entry area with the following keys: 



Completes entry and moves to the OK dialog button. | 









(B 

i 11 fSi j 1 1;ii4 1 y 

.®. 

Cursor moves right one character, up to the entry’s end. 


Belete from file cursor to ffie en3*^*the entry. 

(CTRL)4-(H0ME) 

Delete from the stfrt of the enhy to ihe cursor. 


Simple filenames refer to files in the directory in which you 
started depot4. Full pathnames can be entered, which may 
refer to any drive and sub-directory. 

Some menu options require that you enter numbers. The 
number dialog box lets you enter numeric values. Negative 
numbers are not meaningful and are ignored (treated as zero). 
Help 

The bottom of the screen always contains a help message 
relevant to the menu item that is currently highlighted. 

The Main Menu 

DEPOT4 allows reading and writing data and backup tapes, as 
well as viewing a tape contents of on your video display. 
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This screen is the heart of depot4. 

Using the arrows moves the Select Bar, to a given item. If that 
item offers secondary choices, another menu appears which 
works in the same manner. If an item leads to a program or a 
data window, no menu appears. Press (enter) to select the item. 
For example, sel ectin g information (press (enter) to do so— 
try it now, press (esc) to exit when you're done looking at the 
screen) shows you an overview of the depot4 information. 

Programs and Data Windows 

Remember each utility program is a stand alone and can be 
used alone. Detailed explanations for each standard utility are 
as follows; depot2, page 60; fddmp, page 84; label, page 92; 
and TAR, page 175. 

Change or select an item by highlighting it and pressing (enter) 
(this will not run the program until you select Execute). 

If a selection toggles between two choices, (enter) changes that 
item. If it requires you to enter data, it opens a dialog box. 
Continue to change items as needed, pressing (T) to move to 
the next item, until you highlight Execute. Press (enter) to 
execute the program as you have directed, press © to move to 
the first item to let you to change it; press (He) to escape. 
DEPOT4 will return you to the depot4 program after you exit 
from any of the Overland Data utility programs. 
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Selecting Read Tape gets you the Read Unlabeled Tape 
window. Enter the filename (the item automatically highlighted 
when you enter the screen), and press © to move to the next 
item. The small depot 2 Command Line window shows the 
DEPOT2 command line that will be selected. 


SEFOM Revision: 1.2 - (c) 1936 Overland Data Inc. 


■[ Read Unlabeled Tape ]' 


Fllenane 




Translate 

NO 

Read To EOF 

YES 

Uerbose 

YES 

Blocks To Read 

6 

Strip? 

NO 

Records To Read 

e 

Record Size 

6 



Block Factor 

6 



Skip Files 

6 



Skip Blocks 

e 

EXECUTE 



. [ DepotZ CoMnand Line ] . . .. ■ — m . . 

depotZ /u /n /n DniRFlLE 

..... . . [ Full line Help 3 . ' "" '■■ ■ -.. -.- 

Use this function to enter the name of the file you yish to create on the 
disk uhen reading froM tape. Multiple filenames or DOS wildcard characters 
(« or 7) will not be recognized. You nay enter a complete path name if you 
wishe.g.: D:\databaseSmaillist.txt 


Selecting write Tape brings up a menu where you select 
labeled or unlabeled tape. 


DEPQId.e - (cl 1990 Overland Data Inc. 



I Main Menu ] 
ornatlon 
:ad Tape 


n 


IlfKiEBSDISEEJEr 

j)os I Write ]|nlabclcd 


Tape 


Novell Restore 


Full Tine Help 3- 
s with [DM or ft\3i 


jlisc this function to write tapes with [DM or RhSi tape labels. A tape 
label consists of a short data file urilten to the tape before the user data 
is wrlttcnj which contains data that idenitfies the following data file. 
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Selecting labeled tape runs Overland Data's label program, 
which offers you a data window where you may set the 
options. Selecting unlabeled tape allows you to choose the 
appropriate options for depot2. Selecting Execute will execute 
DEPOT2 using the options you selected. The small Depot2 
Command Line window shows the command line which will be 
executed. 

Selecting view Tape will run fdump. 

DOS Backup/Restore will offer you the choice of standard 
Backup/Restore or FLASHBAK. Run FLASHBAK if you have 
purchased that (optional) program, otherwise it will inform you 
that it cannot find flashbak. Or run standard 
Backup/Restore (tar). 

Selecting Novell Backup will run NOVELL TAR, allowing you 
to use the tar backup program for Novell, if you have the 
Novell version of tar. If not, it will inform you that this selection 
requires the purchase of that option. The small tar Command 
Line window shows the command line which will be executed. 
Selecting Novell Restore will run tar, allowing you to 
restore your backed up Novell system if you have the Novell 
version of tar. If not, it will inform you that this selection 
requires the purchase of that option. The small tar Command 
Line window shows the command line which will be executed. 
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DEPOT 

DEPOT (Data Exchange Program with Optional Translation) lets 
you transfer data between system disk and 9-track half-inch 
tape. You can transfer data to or from tape in its binary form, 
or request translation between ASCII (American Standard Code 
for Information Interchange) and EBCDIC (Extended Binary 
Coded Decimal Interchange Code). 

Features 

DEPOT allows the following: 

• Data interchange from tape to disk. 

■ Data interchange from disk to tape. 

■ Conversion from ASCII to EBCDIC. 

■ Conversion from EBCDIC to ASCII. 

■ Positioning to arbitrary location prior to data read. 

You can append data from disk files to existing data tapes, or 
you can record data at the beginning of a new tape. 

You can recover data recorded on tape by specifying file 
number, data block within the file, and the amount of data to 
read. 

Character translation takes place (if required) in system memory 
before depot writes the data to tape or disk. 

Storing Data on Tape 

The data to be stored on tape must exist in a disk file, depot 
transfers the entire disk file to tape without interruption. The 
disk file is not modified. 

DEPOT stores data on tape as sequential files of data blocks. 

Each data block is a binary image of the data in the specified disk 
file. DEPOT separates each file from the preceding file by one 
filemark, and terminates the last file with double filemarks to 
indicate the logical end of tape, depot does not maintain a tape 
directory and does not insert any identification bytes. 

You must specify the size of the data blocks to be written to 
tape. The tape block size can be any number between I and 
65280 bytes. 

In general, larger (2kB to 16kB) block sizes allow more data to 
be put on one tape. For example, a 2400-foot tape with 80- 
byte data blocks will yield approximately 3MB of storage. The 
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same tape written with 8192 byte (8kB) data blocks yields 
40MB of storage. 

You can append a file to a tape already containing data, depot 
locates the two filemarks which indicate the logical end of tape, 
erases the last filemark, and writes the new file, depot 
terminates the appended file with two filemarks and rewinds. 

If the last sector of the disk file does not completely fill the last 
tape data block, depot truncates the data block (it writes a 
short data block to tape). 

Recovering Data From Tape 

DEPOT recovers data by locating the specified file and the 
specified first block in the file and reading the data. Because 
there is no directory of the data on the tape, depot locates the 
file by counting the number of filemarks from the beginning of 
the tape. It locates the data by counting the number of blocks 
(delineated by tape gaps) from the filemark. The first block of 
any file is number zero. 

DEPOT reads the data from the tape regardless of the size of 
the recorded block (up to the maximum). 

DEPOT will not operate if block size is larger than 65280 bytes. 
DEPOT creates a new disk file to accept the data from tape. It 
records the data on the disk by using the operating disk file 
management system. If the disk file already exists, depot asks 
for permission to overwrite it. If an error occurs during a tape 
operation or a disk operation, depot will tell you about the 
problem and usually suggest something you may be able to do 
to correct it. A table later in this section describes your possible 
responses to an error condition. 

Use 

Find a blank tape, insert a write enable ring in the back of the 
tape reel, and load it onto the tape drive. This will write to the 
tape—be sure the tape you use has nothing important on it. 
When the tape is loaded, put the drive online. 

Load DEPOT by typing: 

C:\> depot 

followed by (enter) , depot displays a logon message, followed by 
a copyright notice, serial number and version. Then depot sets 
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up the data buffer and checks the tape drive status. The drive 
must have a tape loaded and be on line. 

Main Menu 

If all is ok, DEPOT will display the menu; 

1 Write a new tape 

2 Append to an existing tape 

3 Read a tape 

4 Exit to DOS 

Your choice? —> 

Enter the number corresponding to the operation you need. 

Translation 

If translation is needed, type y and (enter) at the prompt; 

Is data conversion necessary? 

Any other response will skip data conversion. If requested, 
DEPOT then displays the data conversion menu; 

Enter: 

1 - If ASCII to EBCDIC 

2 - If EBCDIC to ASCII 

(1 or 2) —> 

Writing a New Tape (Option 1) 

This option assumes the tape mounted on the drive has no valid 
data recorded on it. depot writes new data at the beginning 
of tape, overwriting any previously recorded data. When the 
file transfer is complete, depot writes two filemarks, rewinds 
the tape and returns to the main menu. 

You must enter the name of the disk file in response to; 

Name of file to write to tape? 

Enter the name in the form; 

[d:] filename (ENTER) 

where [d;] is an optional drive specification, and filename is the 
complete disk path name (including any extension). 

To write file c: \maii\iisti, type the path name as follows; 
Name of file to write to tape? C:\mail\listl 
DEPOT searches the file system for that filename. If it finds it, it 
opens it for reading. If it doesn't find the file, prints the 
message; 
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Can't open 'filename'. 

Check your file name or path. 

When you press a key, you will return to the main menu. 

You must also indicate the size of the data blocks to write to 
tape, prompts: 

Size of data block to write to tape (1-65280) —> 
where 65280 is the maximum size allowed in bytes. 

Prior to writing to tape, depot checks the drive status to insure 
that the tape is write enabled. If it is not, depot warns you of 
the problem and waits until you request it to try again (T), or 
stop (S). Choosing stop will take you back to the main menu. 
When all is in order, depot begins the data transfer and 
continues until the entire disk file is written to tape. 

If translation is going on, depot prints a dot for each tape 
block. 

If an error occurs during writing, depot makes ten or more 
attempts to write the data correctly. If unsuccessful, it displays: 

An unrecoverable write error has occurred on 
tape. Press any key to continue ... 

You can not continue to write after a tape write error has 
occurred, so depot takes you back to the main menu. A tape 
write error is usually caused by a tape being worn out, but it 
may also be due to a dirty head or other drive problem. 

If the file does not completely fit on the tape, depot writes 
what is already in the cache onto the tape. Then it says: 

Physical End of Tape Detected. 

Writing two filemarks and unloading tape. 

Mount new tape. 

Press any key to continue ... 

When everything is in order, depot will continue writing the rest 
of the file on the next tape. 

Appending to an Existing Tape (Option 2) 

With this option, depot looks for two consecutive filemarks on 
tape and positions the recording head between them. It 
assumes there is no useful data beyond the second filemark. If 
the tape is full, depot will warn you and go back to the main 
menu. 
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After positioning the tape to the logical end. Appending to 
Tape follows the same procedure as writing a new tape. 

Reading a Tape (Option 3) 

This option reads specified data from tape and (after any 
translation) puts it in the disk file. If either the logical EOT or 
physical EOT marker is encountered while positioning or reading, 
DEPOT will give a warning and allow you to continue (C) or stop 
(S). If the physical EOT marker is encountered while reading, 
you must select continue in order to finish reading the present 
file on the present tape. If a file begins on one tape and ends on 
another, you must read the first part of the file (as above), and 
then load the next tape and read the first file as if it were a 
separate file. Then combine the two partial disk files into one file, 
using the DOS command; 

copy filel. ext/b + £ile2 . ext complete . ext (ENTER) 

This is necessary as depot has no way of knowing that the file 
continues on another tape. If you try to continue beyond 
physical EOT and have already passed logical EOT, it is possible 
for the tape to come off of the supply reel. 

When DEPOT is reading a tape, many additional options are 
available which allow only selected data to be transferred. We 
cover each option individually and in the order usually 
encountered within depot. 

1 . File Number, depot locates the requested tape file by 
counting the filemarks from the beginning of tape. Provide 
this information in response to: 

Number of filemarks to skip? —> 

Since filemarks are only written at the end of a file, the 
filemark count is one less than the number of the file on 
tape. That is, the first file on tape is zero filemarks from 
the beginning of tape. And, the third file is two filemarks 
from the beginning of tape. 

Warning!! depot has no way to know whether the number 
of filemarks to skip is reasonable. 


2. Blocks to Skip, depot skips any number of blocks, 
allowing you to select a beginning block number within the 
file. Enter the number of data blocks to skip in response 
to; 
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Number of data blocks to skip? —> 

DEPOT positions the tape to read the n -i- 1 data block, 
where n is the number of blocks to skip. 

Warning!! depot has no way to know whether the number 
of blocks to skip is reasonable. 


3. Truncation, depot provides an option to transfer only 
part of a data block, allowing easy handling of some card 
image files. When you request truncation, depot 
transfers only a specified number of bytes of each data 
block. It appends a carriage return and a line feed to the 
data in system memory before it writes the data to disk. 
To request truncation, respond y followed by (enter) to 
the following prompt, and specify the number of bytes 
depot should read from each record: 

Truncate data blocks (Y/N) ? —> 

Size of record to read ? —> 

4. Disk File. When reading a tape file to disk, depot creates 
a new file to receive the data. 

Filename to create on disk? —> 

Enter the disk file name in the form: 

[d:]filename 

where [d:] is an optional disk specifier and filename must 
include the extension and may include the path, depot 
searches the file system for a file with the new name, and 
if one is found, prints 

File <filename> already exists. 

Overwrite? (Y/N) 

If you respond with a y followed by (enter) , depot 
removes the existing file and creates a new file with that 
name. Any other key allows you to enter a different 
filename. 

DEPOT will warn you if the disk is too full, the path can not 
be found, a floppy diskette is write protected or if the 
existing file is 'read only". 

5. Reading the Tape. After depot opens the disk file for 
writing, you must specify the method of reading the tape. 
Your choices are: 
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Select option for data read size. 

1 Read until next filemark is encountered 

2 Read n blocks 

3 Read n bytes 

Your choice? 

The following table describes these options: 

~] Reading and data transfer begin at the current 
tape position and continue until depot finds a 
filemark. 

2 Reading and data transfer begin at the current 
tape position and continue until depot reads the 
set number of data blocks. 

3 Reading and data transfer begin at the current 

tape position and continue until depot reads the 
specified number of bytes. _ 

If you select option 2 or 3, depot prompts for the 
number of data blocks or bytes to read. 

Warning!! depot has no way to know whether the number 
of blocks to read is reasonable. It is possible to read blocks 
beyond the end of the present file. 

Multiple Volume Tape Writes 

If your tape write requires more than one tape to successfully 
backup all the data, depot will write to the end of the tape, 
terminate the current write, write two filemarks, and prompt 
you for anew tape to be mounted. Once the new tape is 
mounted, depot will continue the incomplete write operation. 

Error Handling 

DEPOT automatically retries tape errors 10 times. If the failure 
persists, you will be warned that an error has occurred. The 
message will tell you what happened and what you may be able 
to do about it, if it's not obvious. You usually chose how to 
proceed, but sometimes there is only one choice. The following 
table shows the possible choices when an error has occurred: 
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Error Messages 


Key 

Message 

Meaning £. Effect 

s 

Stop Trying 

Discontinue present operation. 
Usually returns to the main menu. 

■ 

Try Again 

Another attempt is made on the 
failing operation. 

c 

Continue Beyond Error 

DEPOT attempts to ignore the 
error. No additional retries are 
attempted on this error. 


Some errors, such as disk failures, will prevent depot from 
continuing. There is no guarantee that a retry will be successful. 
You can never retry errors that occur while writing to tape. 


Limitations 

DEPOT has the following limitations: 

■ The maximum block size is 65,280 bytes. 

■ DEPOT accepts block sizes less than one, but greater than 
zero. 

■ During retries on a damaged tape, depot may lose track of 
the tape position. 
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DEPOT2 

DEPOT2 (Data Exchange Program with Optional Translation— 
version 2) provides enhancements to the depot utility. It offers 
increased speed and the convenience of command file execution. 
DEPOT2 transfers data between system disk and magnetic 
tape, either in its binary form or with optional translation. The 
program assumes that data to be translated to EBCDIC is 
ASCII and data to be translated to ASCII is EBCDIC. 

Features 

DEPOT2 has the following features; 

■ Copies data from tape to disk 

■ Copies data from disk to tape 

■ Converts data from ASCII to EBCDIC (optional during tape 
writes) 

■ Converts data from EBCDIC to ASCII (optional during tape 
reads) 

■ Positions to an arbitrary tape location prior to read 

■ Permits user specified record sizes with a blocking factor 

■ Reads options from the command line 

■ Optionally reads commands from a file, permitting batch files 
for multiple tape operations. 

■ Has enhanced error handling of tape errors and disk errors. 

■ Has enhanced support for writing multivolume tapes. 

Reading from Tape 

The absence of option /w and /a specifies a read operation. 

The /r and /b switches are normally only used with ASCII text 
files, as the automatic padding will make executable files useless. 

Specify the destination file name, such as /n out file, and the 
stopping criteria (such as reading until depot2 reads a 
filemark; /m). You use the same switch, /n, for both the source 
and destination file. The tape operation (read or write) dictates 
how DEP0T2 uses the file. If the file already exists for a tape 
write operation, depot2 asks for permission before 
overwriting. If /i (ignore) is used, depot2 assumes permission 
to overwrite. 

On read, you may also specify a deblocking factor, a record size, 
files or blocks to skip, and translation (EBCDIC to ASCII). 
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Record Size and Blocking Factor 

Record size and blocking factor are intended for use with ASCII 
disk files where records are delimited by carriage returns and line 
feeds. While writing to tape, lines in the source file which are 
longer than record size will be truncated and lines which are 
shorter than record size will be padded with spaces; in either 
case, the CRLF characters are not written to tape. When 
reading a tape which was written with record size specified, 
that same record size should be specified again in order to 
restore the file to its original format (this assumes the written 
record size was large enough to prevent truncation of lines); 
the CRLF characters are inserted in the disk file. 

Disk files which are in EBCDIC or binary may contain certain 
characters which are interpreted as control codes. This can 
cause these files to be modified when record size and blocking 
factor are specified. You may read EBCDIC or binary disk files to 
tape by specifying the blocksize (/s). 

When using depot2 to read a tape, remove the write enable 
ring for extra protection and load the tape onto the tape drive. 
For DEPOT2 to write a tape, put a write enable ring on the 
reel and load the tape onto the drive. 

Note; If you are writing to tape, make sure the tape you 
choose has nothing important written on it. 

When the tape is loaded, place the drive online. Invoke depot2 
from the command line, specifying any options, as follows 
C:\> depot2 options 

followed by (enter) , where options is one or more of the 
option switches specified below. Use option /c filename to tell 
DEPOT2 to read filename instead of the command line for its 
program options. depot2's options consist of one or more 
switches separated by spaces. A switch is / (slash) followed by a 
letter. If a switch needs an argument, put it after the letter 
with a space. (The space is optional if the argument begins with 
a number.) For example, the following option specifies that the 
tape block size is 1024 bytes; 

/s 1024 
or 

/sl024 
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You may combine toggle options (ones not requiring 
arguments) with a single slash, as in: 

/tvM 

This specifies options translate, verbose, and stop reading at 
filemark detection. 

The following table describes the depot2 read tape options. 


DEPOT2 Read Options 


Switch 

Argument 

Description 

/c 

filename 

Reads filename for DEPOT2 commands. If it is 
present, DEPOT2 will ignore any other switches 
on the command line. 

7t 


translate data from EBCDIC to ASCII on tape 
read. 

/n 

name 

Gse name for destination on tape read 
operations. 

name must include the extension 

/r 

vai 

Use record size val. 

/b 

val 

Gse blocking factor vai. the default is 1. 

/v 

SNNMMHI 

Verbose. 

/i 


Ignore errors (but print error messages). 

7m 

val 

Skip vai filemarks. 

/d 

val 

Skip vai data blocks. 

/B 

val 

Read vai data blocks. 

/R 

val 

Read vai records. 

/M 


Read until dep6t2 detects a filemark. 

/P., i 


Set data bit 7 to 0. 

7s 

val 

Use val block size. 

/k 1 


Ignore single filemarks, allowing files being read to 
be concatenated into a single DOS file. It must be 
asserted for each command line 


Note: An important consideration when setting the r and b 
switches is that the r switch causes a CRLF (carriage-return 
line-feed) to be inserted after each record, which is useful when 
moving data into a database or spreadsheet. 

Writing to Tape 

Use option /w (write) or /a (append) to write to tape. Specify a 
block size (such as /s 1024) and a source file (such as /n 
infile) or you may specify a record size (/r) and a blocking 
factor (/b; the default is I). 
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Use either s or r and b. Do not use s with r and b. Doing so is 
redundant (setting r and b defines the block size, s; setting s 
defines both the record size, r, and blocking factor, b). The /r 
and /b switches should normally only be used with ASCII text 
files, as the automatic padding makes executable files useless. 
You can also specify translation (/t) (ASCII to EBCDIC on tape 
write), the number of filemarks (/m) or data (/d) blocks to skip. 

Record Size and Blocking Factor 

Record size and blocking factor are intended for use with ASCII 
disk files in which records are delimited by carriage returns and 
line feeds. While writing to tape, lines in the source file which are 
longer than record size will be truncated and lines which are 
shorter than record size will be padded with spaces. When 
reading a tape which was written with record size specified, 
that same record size should be specified again in order to 
restore the file to its original format (this assumes the written 
record size was large enough to prevent truncation of lines). 
Disk files which are in EBCDIC or binary may contain certain 
characters which are interpreted as control codes. This can 
cause these files to be modified when record size and blocking 
factor are specified. You may write EBCDIC or binary disk files 
to tape by specifying the /s option. 

Note: It is unnecessary —a waste of your time and effort, in 
fact—to use /s when you use /r and /b, or vice versa. Use 
either, as you choose. 

The following table describes the depot2 write tape 
commands. 
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DEPOT2 Write Options 


Switch Argument Description 


/c 

filename 

Reads filename for DEPOT2 commands. If it is 
present, DEPOT2 will ignore any other 
switches on the command line. 

/t 


Translate data from ASCII to EBCDIC on tape 
write. 

7n 

name 

Use name of disk file. 

name must include the extension 

/r 

val 

Use record si 2 e val. 

/b 

val 

Use blocking factor val. the default is 1. 

7s 

1 val 

Gse val block size. 

7v 


Verbose. 

7i 


Ignore errors (but print error messages). 

7m 

[ val 

Skip val filemarks. 

/d 

1 val 

Skip val data bioci«. 

7a 


Z^pend to tape. 

/w 


Write new tape. 

/p 


Set data bit 7 to 0. 


Multiple File Operations 

The /c ("filename") switch is very powerful, allowing you to 
create a depot2 command file, running a series of depot2 
commands without supervision. An example of this, with more 
detailed explanation, follows, under Example Command File. 
Note: It is unnecessary to use /s when you use /r and /b, or 
vice versa. Use either, as you choose. 


Warning!! 

Results may be unpredictable if you use both the /s and the /r 
and /b options. Do not use both 
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Options 

This summary table describes all the depot2 command options. 

DEPOT2 Read and Write Options 


Switch Argument Description 


/c 

filename 

Reads filename for DEP0T2 commands. If it is 
present, DEPOT2 will ignore any other switches 
on the command line. 

/t 


Translate data from EBCDIC to ASCil on bpe 
read. Translate data from ASCII to EBCDIC on 
tape write. 

7n 

name 

Use name of disk file on tape write operations. 

Use name for destination on tape read 
operations, name must include the extension 

/r 

val 

Gse record size val. 

/b 

val 

Use blocking factor val. The default is 1. 

7s 

val 

Use val block size. 

/v 


Verbose. 

/i 1 

SBBBB 

ignore errors (but print error messages). 

/m 

val 

Skip val iilemarks. 

7d 

val 

Skip val data blocks. 

/a 


Append to tape. 

7w 


Write new tape. 

/B 

. 

Read val data blocks. 

/R 

. 

Read val records. 

7m 


Read until DEPdT2 detects a filemark. 

“/p“ 

BBBH 

Set data bit 7 to 0. 

7k 


ignore single filemarks, allowing files being read to 
be concatenated into a single DOS file. It must be 
asserted for each command line. 

7w 


Suppresses the 'wait for user approval to exit 
keystroke' (normally the program waits for a user 
keystroke before exiting, to allow you to see what 

1 has been done; this switch tells it not to wait). 


Exit Codes 

When DEPOT2 finishes and returns to DOS, it returns a status 
byte which a batch file can examine to determine if an error has 
occurred. A value of zero indicates no error. Each bit indicates a 
type of error. More than one bit may be on at a time. If an 
error is detected and a retry is successful, then no error codes 
bit will be set. This table shows the meaning of the exit codes; 
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DEPOT2 Exit Codes 


Decimal 

Hex 

Error Indication 

128 

80 

Tape write 

64 

40 

Tape read 

32 

20 

Tape position (skipped too many files or blocks, etc.) 

16 

10 

Disk write (path not found, write to “read only". 



etc.) 

8 

8 

Disk read (file or path not found, etc.) 

4 

4 

Disk other than read or write 

2 

2 

No command switches, no controller, lacks memory 

1 

1 

Miscellaneous (block too big, file not closed, etc.) 

0 

0 

No Error 


Multiple Volume Tape Writes 

If your tape write requires more than one tape to successfully 
backup all the data, depot will write to the end of the tape, 
terminate the current write, write two filemarks, and prompt 
you for anew tape to be mounted. Once the new tape is 
mounted, depot will continue the incomplete write operation. 
Error Handling 

If an error occurs during reading or writing of a tape, depot2 
automatically retries the operation 10 times. If the failure 
persists, you will be warned that an error has occurred. The 
message will tell you what happened and what you may be able 
to do about it, if it’s not too obvious. You chose how to 
proceed, but sometimes there is only one choice. If you chose 
not to continue, depot2 will stop running the present 
command line. If the /i (ignore) switch is used, depot2 will 
continue with the next line of the command file (if any). The /i 
switch causes most errors to be ignored, but you will always be 
warned of any serious error. Some errors, such as disk failures, 
will prevent depot2 from continuing. There is no guarantee 
that a retry will be successful. You can never do additional 
retries on errors that occur during writing to tape. If you see 
the write error message, the automatic retries have already 
happened. 

This table shows the possible choices when an error has 
occurred: 
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Error Messages 


Key 

Message 

Meaning & Effect 

s 

Stop Trying 

Discontinue present operation. 
Usually returns to the main menu. 

■ 

Try Again 

Another attempt is made on the 
failing operation. 

c 

Continue Beyond Error 

DEPOT2 attempts to ignore the 
error. No additional retries are 
attempted on this error. 


If the physical end of filemarker is detected while reading or 
positioning tape, you will be asked whether to continue the 
operation. This warning will normally appear only once (in 
command file operation, the warning will appear for all 
command lines which do not use the /i switch). 

If the physical end of filemarker is detected while writing or 
appending to a tape, depot2 will finish writing all data in the 
cache, write two filemarks, and unload the tape. You will be 
warned that EOT was reached and asked to load a new tape to 
continue writing the unfinished file. If you select verbose (/v), 
you will be told the name of the file which spans two tapes. 

Command Line Examples 

Example 1; 

This command sets the verbose option and writes the contents 
of disk file input. txt to tape, translating from ASCII to 
EBCDIC and using a 1024 b^e block size. depot2 will ignore 
any errors. 

C:\> depot2 /vwti /n input.txt /s 1024 
Example 2: 

To read this file, we instruct depot2 to read the first file (stop 
reading at first filemark), translating it back to ASCII. depot2 
writes the data to file out. txt. Here is the command: 

C:\> depot2 /tM /n out.txt 

You do not have to specify block size (it reads a block at a time 
from tape), or an explicit read operation (the absence of /w and 
/a implies read). 

Example 3: 

The following command appends a file to tape, writing 80 byte 
records, with a blocking factor of 100 (that is, 100 records per 
block). It writes the contents of disk file cardfile: 
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C:\> depot2 /av /r80 /blOO /n cardfile 

Example 4: 

To read and write binary or executable files, do not specify 
translation. For example, the following command copies disk file 
output. bin to tape, using a 2048-byte block size; 

C:\> depot2 /wv /n output.bin /s 2048 

Similarly, to read a file from tape (again, without translation), 

use a command such as: 

C:\> depot2 /vM /n input.bin 

This creates disk file input.bin. Again, we use option /m to 

stop reading at a filemark. 

Example Command File 

We include a sample command file, cmd, on the distribution disk. 
Important Note; This example shows how you can set depot2 
to perform multiple and/or repetitive tasks. Note that each 
DEPOT2 task requires a separate line in the command file you 
create, although the operations that make up a task can (and 
should) be kept together on one line. 

Here are the contents of the sample file: 

; This is a sample command file that illustrates 
; how multiple tape operations may be specified 
; for repetitive tasks. Please note that comment 
; lines MUST begin with a semi-colon 
; in the FIRST column of text. 

; Write read.me file with fixed length records, 

; 50 per block. The "w" switch indicates writing 
; from the beginning of the tape. 

/wv /r78 /b50 /n read.me 

; Write it again as a straight image. 

; The remaining write operations are specified 
; with an "a" switch set to append these files 
; to the existing data on tape. 

/av /s 1000 /n read.me 

/ Write it this time with short records, 

; truncating lines. 

/av /r40 /b50 /n read.me 

; Write it this time with long records, and 
; larger block factor. 

/av /rl20 /blOO /n read.me 
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; Write it again with short records^ and smaller 
; block factor. 

-/av /r40 /b30 /n read.me 

; Write one last time in EBCDIC, with 80 byte 
; records and short blocks 
/avt /r 80 /b 10 /n read.me 

; Read the first file, deblock it and write it 
/ back to disk. 

; Stop when a filemark is reached. 

/vM /r78 /b50 /n test 

; Read and reproduce the straight image. 

/vM /n testl /m 1 

/ Read file written with truncated lines, but 
; only the first thirty lines. 

/v /r 40 /b 30 /m 4 /n test2 /R 30 

; Read the first file, deblock it and write it 
/ back to disk. 

; This time stop after reading only one data 
; block. 

/v /r78 /b50 /n test3 /B 1 

; Read the EBCDIC version. Note that if you use 
/ the DOS "TYPE" command to examine this file, it 
; will appear to be double-spaced, due to 
; the auto-wrap function of the display. Viewing 
/ the file with a text editor will eliminate 
; this illusion. 

/vtM /r80 /blO /m5 /n test4 

DOS Batch File Examples 

Example 5: 

This batch file will show a warning if there is ANY error: 

echo off 

depot2 /c cmdlist 

if errorlevel 1 echo ** DEPOT2 RETURNED AN ERROR ** 
rem If DEPOT2 returns a status byte equal or ... 
rem greater than 1 the "echo" message will be ... 
rem printed on the screen 

Example 6; 

This batch file will warn only if there is a tape error; 
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echo off 

depot2 /c cmdlist 

if errorlevel 32 echo ** DEPOT2 RETURNED A TAPE ERROR ** 
rem If DEP0T2 returns a status byte equal or greater than 
rem 32 the "echo" message will be printed on the screen 

Limitations 

DEPOT2 is limited to a 65,280 byte block size. 

DEPOT2 accepts block sizes less than one, but greater than 
zero. 

During retries on a damaged tape, depot2 may lose track of 
the tape position. 

The /r and /b switches should normally only be used with ASCII 
text data files, as the automatic padding will make executable 
files useless. 

Bugs 

If the /n (name) switch is used without being followed by a legal 
DOS filename, strange filenames may result. 

In command file operation, if the last line of the command file 
happens to exactly fill a tape, depot2 will prompt for an 
additional tape to be loaded, then exit normally. 
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DEPOTS 

DEPOT3 (Data Exchange Program with Optional Translation, 

Version 3) is a flexible, programmable utility for reading 9-track 
tapes. At present, tapes may only be read using depots. 

Use 

To use DEPOTS you must prepare a script file. The script file 
contains keywords that are programming commands for 
DEPOTS. After creating the script file, execute by typing; 

C:\> depots scriptfile (ENTER) 

at the DOS command prompt. In this case, we placed our script 
in the file scriptfile 

Creating Script Files 

Use your favorite text editor to create a depots script file. A 
script file contains a series of lines with a keyword on each line. 
Keywords are always lower case. Some keywords require 
parameters (or arguments). The arguments follow the keyword 
and are separated by spaces. For example, to write a field 
defined by bytes 16 through 31 inclusive from each record, use 
the writedata command followed by the starting and ending 
byte number, as follows; 
writedata 16 31 

Note that the first byte in a record is byte I (not byte 0). Never 
use a negative byte position, as this will cause erratic behavior. 

To separate this field with a carriage return line feed, use the 
same command, followed by a command, as follows; 

writedata 16 31 
crlf 

Follow these guidelines when creating your script; 

■ Place each command on its own line. 

■ In addition, all commands must be contained on a single line. 

■ If the command requires parameters, they follow the 
keyword. Separate the parameters with tabs or spaces. 

■ Number parameters (those that define a byte position, for 
example) must increase (or remain the same). 

■ Use a semicolon in column 1 to place comments in your script. 

When creating a script, you must include these commands; 
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outfile 

recordsize 


begdata 


enddata 


Specifies the output file (on disk). The file must 
not already exist. 

The tape block's record size, depots makes 
sure that any field parameters are within the 
defined record size. The recordsize parameter 
must match what is actually on the tape. 

Every command before this is performed once 
before processing the tape's data. Every 
command after begdata is performed once per 
record. 

This marks the end of per record processing. 
You may place echo commands or a chain 
command after enddata. 


The complete list of depots commands is shown at the end of 
the DEPOTS section. A particular script file will only read from 
one file on tape and write to one disk file. Operations on 
additional files will require additional script files. To avoid 
unnecessary rewinding, use the chain command, rather than 
running several times with different script files. 

DEPOTS automatically stops when it encounters a filemark. 


Example Scripts 

Example 1; 

The following script creates output file .v test by reading a tape 
containing records of 130 bytes. Before depots reads any 
data from tape, it writes the lines: 

Sample Script File Output 
Data from tape 2044: 

to the output file. 

Here is the script: 

; comments can go after semi-colons 
outfile test 
recordsize 130 

echo "Sample Script File Output" 
crlf 

echo "Data from tape " 

echo "2044:" 

crlf 

begdata 

; write last name first, followed by first initial, as follows 

; "lastname”,”i" 

echo /"/ 

writedata 16 31 

echo /","/ 
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writedata 1 1 
echo /”/ 
crlf 
enddata 

The echo command writes its argument to the output file. You 
must enclose the echo argument in double quotation marks (or 
another non- alphanumeric character). The crlf command 
writes a carriage return line feed sequence to the output file, 
begdata marks the beginning of data processing. 

The script then writes the lastname field (bytes 16 through 31) 
enclosed in double quotation marks, a comma, and the first 
initial field (byte 1) enclosed in double quotation marks. We 
terminate each record with a carriage return line feed sequence 
(crlf). enddata signals the end of data processing. 

Here is a sample of file test after executing the above script: 

Sample Script File Output 
Data from tape 2044: 


Kimelman 

, ”D" 

Wittels 

II T ff 

r 

Veyhl 

, "E" 

Harrison 

, ”L" 

Schechter 

, ”D" 

Sandstorm 

, "P" 

Short 

, "K" 

Rasp 

, ”R" 

Lange 

, "D" 

Oswald 

, ”R” 


Example 2: 

This script file shows the flexibility of the writedata command 
combined with the crlf command. The tape that we want to 
read is the same format as the previous one, but we format the 
data differently. Here, we place labels for the initial and last 
name in the output file, and separate each record with two 
carriage return line feed characters. Here is the script: 

; comments can go after semi-colons 

outfile testl 

recordsize 130 

echo "Names from Tape 2044" 

crlf 

crlf 

begdata 

; write labels indicating first initial and lastname: 

; First initial: 

; Lastname : 
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echo "First initial:" 

writedata 1 1 

crlf 

echo "Lastname 

writedata 16 31 

crlf 

crlf 

enddata 

Here is a sample of the file created from the above script: 

Names from Tape 2044 
First initial:D 
Lastname :Kimelman 

First initial:! 

Lastname iWittels 

First initialiE 
Lastname :Veyhl 

First initial:L 
Lastname :Harrison 

Example 3; 

It is frequently convenient to examine the label information on 
IBM labeled tapes. IBM labels are the first 3 blocks on a tape. 
Each label block is 80 bytes long. 

The first block (labeled VOLl | contains volume information, the 
second contains Header 1 information (HDRl), and the third 
contains Header 2 information (HDR2). Because each block has 
fields defined differently, we must use the depots conditional 
(the if command) to process each block correctly. Also, we use 
the if command to look at the values of various fields (defined 
by the byte position) and print information based on these 
values. 

Here is a script that will read such a tape and display the volume 

label information in the output file: 

outfile labellook 

recordsize 80 

blktread 3 

echo "IBM Tape Label Contents" 

crlf 

crlf 

begdata 

toascii 1 80 
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if 1 4 .eq. "VOLl" 
echo "Volume ID: " 
writedata 1 4 
crlf echo "Serial ID: " 
writedata 5 10 
crlf 

echo "Owner ID: " 
writedata 42 51 
crlf 
endif 

if 1 4 .eq. "HDRl" 
echo "Data Set Identifier: " 
writedata 5 21 
crlf 

echo "Creation Date: (year - day of year)" 

crlf 

echo " 

writedata 43 44 
echo " - " 
writedata 45 47 
crlf 

echo "Expiration Date: (year - day of year) 

crlf 

echo " 

writedata 49 50 
echo " - " 
writedata 51 53 
crlf 
endif 

if 1 4 .eq. "HDR2" 
if 5 5 .eq. "F" 

echo "Record format is fixed length." 
crlf 

echo "Block length: " 

writedata 6 10 

crlf 

echo "Logical record length: " 
writedata 11 15 
crlf 
endif 

if 5 5 .eq. "V" 

echo "Record format is variable length." 
crlf 

echo "Maximum block length: " 
writedata 6 10 
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crlf 

echo "Maximum logical record length: " 
writedata 11 15 
crlf 
endif 

if 5 5 .eg. "U" 

echo "Record format is undefined length." 
crlf 

echo "Maximum block length: " 
writedata 6 10 
crlf 
endif 

if 37 37 .eg. "A" 
echo "Data contains ASCII control 
characters." crlf 
endif 

if 37 37 .eg. "M" 

echo "Data contains machine control characters . ” 
crlf 
endif 

if 39 39 .eg. "B" 
echo "Blocked records." 
crlf 
endif 

if 39 39 .eg. "S" 
echo "Spanned records." 
crlf 
endif 

if 39 39 .eg. "R" 

echo "Blocked and Spanned records." 
crlf 
endif 
endif 
enddata 
crlf 

echo "End of tape label data.” 

This script uses a few new commands, biktread 3 indicates 
that should stop processing after the third block, toascii i 
80 specifies that depots should translate byte positions 1 
through 80 (the entire record) from EBCDIC to ASCII. The rest 
of the script uses the if command to compare the contents of 
the indicated byte positions in the record with the string in 
double quotation marks. This conditional allows you to execute 
different depots commands depending on the value of various 
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data fields. In particular, we examine the first four bytes of 
each record to identify the VOLl record, the HDRl record, and 
the HDR2 record. 

The format for an if command is; 

if start stop operator string 
command(s) 

endif 

where start is the starting byte position, stop is the stopping 
byte position, operator is the compare operator, and string 
is the delimited compare string. If the compare operation is 
true, DEPOT3 executes all commands following the statement 
until it encounters a pairing statement. You may nest i f 
statements as long as each if is paired with an endif 
statement. 

DEPOTS allows the following compare operators: 


Operator 

Meaning 

.eq. 

True if data field is the same as the string. 

.ne. 

True if data field is different than the string. 

.gt. 

True if data field is greater than the string. 

.It. 

True if data field is less than the string. 


The rest of the script defines certain byte positions to write to 
the output file with identifying labels. 

Here is a sample of the output: 

IBM Tape Label Contents 
Volume ID: VOLl 
Serial ID: BLONG 
Owner ID: 

Data Set Identifier: BOBLONG 
Creation Date: (year - day of year) 

86 - 141 

Expiration Date: (year - day of year) 

86 - 142 

Record format is fixed length. 

Block length: 00800 
Logical record length: 00080 
End of tape label data. 

Example 4: 

This script demonstrates depots's flexibility. Here we request 
DEPOTS to read the label on an IBM label tape, and based on 
the contents of the label, write a second depots script to 
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process the tape's data. The last command we use in the script 
is the chain command, which executes the statements in our 
newly created script file. 

This script assumes that the data is written in EBCDIC, and that 
it is fixed record format. The record size and file, name are read 
from the label. 

Here is the first script file; 
outfile Iblscript 
recordsize 80 
blktread 3 

echo script created by lablread" 

crlf 

begdata 

toascii 1 80 
if 1 4 .eq. "HDRl" 
echo "outfile " 
writedata 5 21 
crlf 

echo "fileskip 1" 
crlf 
endif 

if 1 4 .eq. "HDR2" 
if 5 5 .eq. "F" 
echo "recordsize " 
writedata 11 15 
crlf 
endif 

if 5 5 .eq. "V" 
echo "Abort." 
crlf 
endif 

echo "begdata" 
crlf 

echo "toascii_l_" 
writedata 11 15 
crlf 

echo "writedata 1" 
writedata 11 15 
crlf 

echo "crlf" 
crlf 
endif 
enddata 
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echo "enddata" 
crlf 

chain Iblscript 

Here is the script produced by executing the above program: 

/script created by lablread 

outfile BOBLONG 

fileskip 1 

recordsize 00080 

begdata 

toascii 1 00080 
writedata 1 00080 
crlf 
enddata 

This script sets the output file to skips the first file (that is, the 
label) on the tape, sets the record size to 80, translates the 
entire record to ASCII, and writes it (byte positions 1 through 
80) followed by a carriage return line feed sequence. Note that 
the arguments for outfiie, recordsize, toascii, and 
writedata and were all generated dynamically from data on 
the tape. The script will stop (automatically) at a filemark. 
Example 5. 

The following script uses depots's translation features to 
translate an ASCII (control ) -rZ (hexadecimal 1 a) to a space 
(hexadecimal 20). You can define custom translation tables by 
defining a new translation table (the transdef command), 
filling the table with one or more pairs of hexadecimal numbers 
(using the transfill command), and translating specific fields 
within a record (using the translate command). When 
specifying pairs with the transfill command, the first 
hexadecimal number is the source character value; the second 
hexadecimal number is the target character value. 

DEPOTS's translation mechanism also allows you to modify the 
internal ASCII to EBCDIC table (Table I) and the EBCDIC to 
ASCII table (Table 2) by specifying new hexadecimal pairs for 
Table I or Table 2. 

Here's the translation table script: 

; script to show the translation mechanism 
outfiie nozzzs 
recordsize 132 
; declare table 3 
transdef 3 
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; fill it 
transfill 3 la 20 
begdata 

toascii 1 132 
translate 3 1 132 
writedata 1 132 
crlf 
enddata 

We declare table 3 (transdef 3), fill it with a single 
hexadecimal pair and use (transfill 3 la 2 0) this table to 
translate the entire record (translate 3 i 132). 

Command Reference 


begdata 

start processing each record. | 

blktread num 


blockskip num 

Skip num blocks before reading data. 

chain scriptfile 

Read file scriptfile for more DEPOT3 
commands. If used, this command must be 
the last command in a script file or before the 
begdata command (further commands will 
not process). All DEPOTS options are reset 
(you must respecify outfile, recordsize, 
begdata and enddata and any other 
DEPOTS options). The new script file may 
also have commands to skip files and blocks. 
DEPOTS will rewind the tape after the last 
scriptfile is processed. 

crif 

Write a carriage return and ilne feed to the 
output file. 

echo string 

Write string to the output file, string must 
be delimited (by " or some other non-alpha- 
numeric character, i.e. "string", 'string', 
etc.). You may include spaces In string; it is 
currently limited to 150 characters. 


Maries end of da^^^ 

endif 

Marks the end of an if block. 

endonfile 

Stop processing on a filemark (this happens 

1 automatically). 

fileskip num 

_ 

if start stop op 
string 

rExamine^^ field defined by byte positions 
start through stop and perform the 
comparison (defined by op) with string. If 
the conditional is true, all commands will be 
executed until the pairing endif command is 
found. The if command may be gested. 

if 

_ 
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outfile filename 

Write data to file filename, the file must not 
already exist. 

recordsize num 

the record size is num bytes. You must 
define the record size in each script. 

retread num 

Stop after reading num 

strip7 

Strip the seventh bit (high order) from each 
byte. 

toascii start stop 

translate bytes start through stop from ebcdic 
to ascii. 

toebcdic start stop 

translate bytes start through stop from ascii to 
ebcdic. 

trace 


transdef tablenum 

Declare a translation table tablenum. which 
must be between 3 and 10 inclusive. 

transfill tablenum 

HI H2 ... 

Define the values of the (previously declared) 
translation table tablenum. The values HI and 
H2 are listed as pairs of hexadecimal digits 
(separated by a space), where the first digit 
corresponds to the source value and the 
second digit corresponds to the new (target) 
hexadecimal value. You may list as many pairs 
as fit on a single line. You may use as many 
transfill commands as necessary to completely 
specify the table. Tables 1 and 2 are 
predefined ASCII to EBCDIC (Table 1 ) and 
EBCDIC to ASCII (Table 2). These tables may 
be modified through the transfill command by 
listing the source hexadecimal value followed 
by the new (target) hexadecimal value. 

translate tablenum 
start stop 

Translate bytes start through stop from each 
record by using the translation table tablenum. 

writedata start stop 

Write bytes start through stop from each 
record to the output file. 
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Error Handling 

DEPOTS automatically retries tape errors 10 times. If the failure 
persists, you will be warned that an error has occurred. The 
message will tell you what happened and what you may be able 
to do about it, if it's not too obvious. You usually chose how to 
proceed, but sometimes there is only one choice. There is no 
guarantee that a retry will be successful, especially on a 
damaged tape. The following table shows the possible choices 
when an error has occurred: 


Error Messages 


Key 

Message 

Meaning Effect 

s 

Stop Trying 

Discontinue present operation. 
Usually returns to the main menu. 

T 

Try Again 

Another attempt is made on the 
failing operation. 

C 

Continue Beyond Error 

DEPOTS attempts to ignore the 
error. No additionai retries are 
attempted on this error. 


Disk errors will be explained in easy to understand terms and 
you will usually be able to continue after correcting the problem. 
After the disk error message appears, (enter) will cause DOS to 
retry the disk operation (when that is possible), fisc) will cause 
the program to exit, if you wish. 

If DEPOTS detects an error in a script file, it will display an error 
message with a number, then stop execution. The error 
numbers are described by the following table: 
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DEPOTS Script Error Codes 

Error 

Number 

Description 

1 

Field parameters exceed record size 

2 

Field specifiers out of order 

3 

Failed to recognize keyword 

4 

Ran out of memory during memory allocation 

5 

Parameter was expected but not supplied 

6 

Record size was not set before begdata keyword 

7 

Atternpted to chain dun field definition 

8 

if conditional was not recognized 

9 

String constant exceeded 

10 

Conditionai found outside data definition 

1 1 

Conditional must begin with field definition 

12 

More endif statements than if staternents 

13 

if / endif imbalance exists at end of data definition 

14 

Internal error at enddata: Call technical support 

15 

BCD result larger than input specification 
(future implementation) 

16 

Translation table nurnber out of range 

17 

fable number has been previously defined 

18 

Transfill argument imbalance (must include pairs of 
hexadecimal numbers) 

19 

Attempting to use an undefined table number 

20 

Start byte position is less than 1 


There are other situations which depots will warn you about. 

These warnings do not wait for a response and data transfer 

will continue as usual, whenever possible. The warnings include: 

■ 2 filemarks were found while skipping the requested number 
of filemarks (depots will not read past logical EOT). 

■ Two consecutive filemarks were found while skipping the 
requested number of blocks within a file. 

■ You requested reading more records than found in the file. 
This can be caused by using an incorrect recordsize 
parameter. It can also happen if the actual file (or block) size 
is not a multiple of the recordsize parameter. 

■ DEPOTS found no records at the requested position (there 
may be a file or block there which is shorter than recordsize). 
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FDUMP 

Use FDUMP to examine the contents of a tape, fdump makes no 
assumptions about the format or block size of the tape's data. 
fdump is especially suited to; 

■ Determine the format of a tape 

■ Quickly sample a tape's data visually 

■ Troubleshoot a tape problem 

■ Debug a custom tape utility 

Features 

FDUMP is a screen-oriented, interactive tape reading utility. 

FDUMP allows you to select various functions, including reading 
the next block, positioning to a specific file, reading a specific 
block within the file, displaying a block of data in hexadecimal 
format (and EBCDIC or ASCII), scrolling or paging through the 
block, and jumping to a specific byte in a block, fdump constantly 
displays file number, block number, tape drive status word, 
block size, and whether the data is displayed in ASCII or EBCDIC. 

Finally, fdump displays the meaning of the status word by 
highlighting the description of each bit that is on or enabled. 

Use 

Choose a tape with data on it and load the tape onto the drive. 

FDUMP does not write to tape; it only reads data from the tape. 

Boot DOS and type: c: > fdunp (enter) 

FDUnP 2.3 9/2/88 Controller: TX-8 I 


»> BEGimiNG OF TAPE «< 


hit F3 to read a block 


l<ESC> to EXlll 


7 status help ng Next block FQ Jmp to file TliirriFm Sc roll 

^ Jnp to byte ijK Ascii-Ebcdic Jmp to block H j ^ Page 
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(Your PDUMP version number, date, or Controller model may 
differ.) At this point you may instruct to read the first block by 
pressing function key (r). Alternatively, position the tape head 
at another file before reading (press or read another block 
within the current file (press ®). After each function, pdump 
updates the status information indicating the file number, block 
number, tape drive status word, block size, and data mode 
(ASCII or EBCDIC). Press function key (fT) to view a description 
of the status word. 

Once PDUMP reads and displays a data block, you may view its 
contents by scrolling (press © or ©) or paging (press (pgDR or 
(PGDN) ) through the screen display, or by displaying a specific 
byte address at the first line of the display (press (ID), pdump 
displays the data in hexadecimal notation as well as either ASCII 
or EBCDIC. Press function key (H) to toggle between ASCII and 
EBCDIC display modes. Press function key (fD to read and view 
successive blocks. 

Exit PDUMP at any time by typing (esc) . 

PDUMP's function keys are summarized in the following table: 


PDUMP Function Keys 


Key 

Command Description 

C!D 

Display Status Help 

(H) 

Jump to Byte 

dD 

Read Next Block 

(© 

ASCII—EBCDIC Toggle 

CeD 

Jump to File Number 

(re) 

Jump to Block Number 

© 

Scroll Display Up 

© 

Scroll Display Down 

(PGUP) 

Page Display Up 

(PGDN) 

Page Display Down 

(US 

Exit to DOS 


We describe the function keys in more detail below: 

(fD : Status Help. 

PDUMP constantly displays the drive's status word in 
hexadecimal notation. Pressing (n) displays a description of the 
drive's status word, pdump highlights the description of each bit 
that is enabled, allowing you to easily interpret its value. For 
example, if the status word is 5015 (hex) then bits 0, 2,4, 12 
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and 14 are enabled, highlights the descriptions of IFBY (bit 0), 
IRDY (bit 2), lONL (bit 4), DBYT (bit 1 2), and IDENT (bit 14). 
Status Bits. 

The tape drive's status word (16 bits) has the following 
meaning. 

Bit 0 IFBY 

The drive is busy executing or completing a command. This bit is 
enabled during and just after a command. 

Bit I IDBY 

The drive is in DMA phase of a command. This bit is enabled 
during direct memory access to and from the tape drive. 

Bit 2 IRDY 

This bit is true unless the drive is not selected, not loaded, offline, 
or rewinding. 

Bit 3 IFPT 

The tape is write-protected (the reel lacks a write-enable ring). 

Bit 4 lONL 
The drive is online. 

Bit 5 ISPD 

The last command was high speed (for dual-speed drives only). 
Bit 6 IBOT 

The tape head is at the Beginning of Tape (BOT) marker. 

Bit 7 lEOT 

The tape head is at the End of Tape (EOT) marker. There is a few 
feet of usable tape beyond EOT. 

Bit 8 IHER 

A hard error (uncorrected) occurred on read or write. 

Bit 9 ICER 

A hardware correctable error occurred on read. 

Bit 10 IFMK 

The drive detected a filemark on the last command. 

Bit 11 IRWD 

The drive is rewinding. 

Bit 12 DBYT 

The drive dropped the data busy signal indicating that a 
command completed. This bit is always zero on TXi-16 controllers. 
Bit 13 NRZI 

The drive returned NRZI (Non-Returned to Zero Inverted) 
status. NRZI is an encoding mechanism common in 800 bpi 
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(bytes per inch) drives. Bit 13 may also indicate the alternate 
density in a dual-density tape drive (for example, 6250 bpi or 
3200 bpi on a 1600 bpi dual-density tape drive). 

Bit 14 IDENT 

Either the drive detected an ID (identification) burst for PE 
(Phase Encoded) tape or CCG (Check Character Gate) status 
for NRZI tape. PE is an encoding mechanism common in 1600 
bpi drives. The ID burst occurs only after a read at the 
Beginning of Tape. CCG status occurs with every data block 
read on NRZI blocks. 

Bit 15 PAR 

The controller detected a parity error. This indicates bad cables, 
controller, or tape drive. This bit is always zero on TXi-16 
controllers. 
fra) : Jump to Byte. 

Press dD to display the data from a specific block address at the 
top line of the screen, prompts for the address in hexadecimal 
notation as follows; 

Enter byte position in HEX: 0b43 <Enter> 

Here we specify address 0b43. fdxjmp now displays the data 
beginning at address 0b40 at the top line of the screen. If you 
specify an address larger than the block size, fdump simply 
displays the last portion of the data block. 
fra) : Next Block. 

Press (ra) to read the next block of data. If the tape is at BOT, 
FDUMP reads the first data block. Pressing fra) multiple times will 
read successive data blocks. After a read, fdump reports the 
current file number, block number, tape drive status word, 
block size, and display mode, fdump can read any block up to 
64kB. 

When FDUMP detects a filemark, it responds with this message; 

»> FILEMARK DETECTED «< 
hit fra) to read a block 
Now press (ra) to read the first block of the next file. 

(H): ASCII-EBCDIC. 

Press (H) to toggle the display mode between ASCII and 
EBCDIC. You can press (r) aoy time during the fdump session, 
so you do not need to know ahead of time the character code 
mapping of your tape. 
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fFS) : Jump to File. 

The Jump to File function allows you to position the tape head 
at the beginning of an arbitrary tape file, fdump defines a file to 
include all data blocks between filemarks. The first file is file 0. To 
read an arbitrary file, press ©. fdump prompts; 

Enter file position in decimal: 3 <Enter> 

Flere we specify the fourth file (file 3). fdump will position the 
tape at the beginning of this file and display this message; 

»> FILEMARK DETECTED «< 
hit (F3) to read a block 

Press dD to read the first data block. If you specify the first file 
(file 0), FDUMP responds with; 

»> BEGINNING OF TAPE «< 
hit (F3) to read a block 

If you specify a file number larger than the number of files on 
tape, FDUMP will attempt to find it and respond with; 

»> FILEMARK DETECTED «< 

»> LOGICAL EOT DETECTED «< 

> PROCEED FORWARD WITH CAUTION < 

indicating that the specified file does not exist. This occurs when 
FDUMP reads 2 consecutive filemarks. 

Use the Jump to File function to move both forwards and 
backwards to particular tape files. 

(®; Jump to Block. 

The Jump to Block function allows you to read any block within 
the current file (or position the tape head at the filemark 
separating it from the next file), fdump defines a block to include 
all data separated by IRGs. The blocks may be of any size (up to 
64kB), and fdump will report the size of the most recently read 
block on the display, fdump counts blocks beginning at I. For 
example, to read the third block of the current file, press (fD 
and responds with the following prompt; 

Enter file position in decimal: 3 (ENTER) 

Flere we respond with 3 for the third block. (Remember, blocks 
count from 1 .) fdump now displays the data from block 3. 

If you specify a block number larger than the number of blocks in 
the current file, fdump detects a filemark, positions the tape at 
the first block of the next file, and displays the following 
message; 
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»> FILEMARK DETECTED «< 
hit (fD to read a block 

Press (SHIFT) -hfF3) to read and display the first block of this (that 
is, the next) file. 

If you specify a block number larger than the number of blocks in 
the current file and there are no more files on the tape, fdump 
detects the filemark as before. However, when you attempt to 
read the first block of this next file, fdump detects another 
filemark indicating the Logical End of Tape (EOT), and responds 
with: 

»> FILEMARK DETECTED «< 

>» LOGICAL EOT DETECTED <« 

> PROCEED FORWARD WITH CAUTION < 

Scroll Up, Scroll Down 

Use © and © to scroll the display a line at a time. 

Page Up, Page Down 

Use (pgOp) and (pgdn) to page the display up or down. 

Examples 

To illustrate fdump 's use, we describe the following examples; 

■ Reading a tape containing an unknown format, character 
mapping, or density 

■ Checking the integrity of a tape (quick visual inspection) 

■ Troubleshooting a tape problem 

■ Debugging a custom tape utility program 
Example 1; 

Reading a tape containing unknown data. 

Remove the write enable ring from the back of the tape reel and 
mount the tape on the drive. Boot DOS and call fdump: 

C:>fdaaii^ (ENTER) 

FDUMP immediately reads the first data block. Note fdump 's 
status line as well as the data on the screen. Answering the 
following questions may help you determine the format and 
character mapping of the tape's data. 

I. Did FDUMP read good data? 

Inspect the data, scrolling or paging as needed. Toggle the 
ASCII EBCDIC switch (®). Press to examine the tape 
drive's status word. 
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If Bit 8 (IHER) is true, you may have a bad spot on the tape 
or the tape may be written in a density incompatible with 
your tape drive (in this case, fdump can't read it at all). Use 
(re) to select another block. If this block also returns abnormal 
status, then the density is probably incompatible. 

If Bit 9 (ICER) is true, the data is probably good (as long as 
status Bit 8 is false). 

If Bit 15 (parity error) is set, the data is probably bad even if 
FDUMP returned data. 

2. What's the format of my tape? 

Although programs write tapes in the general format of 
multiple files separated by filemarks and blocks separated by 
tape gaps, the data in the blocks may have meaning about 
how the rest of the data is formatted. For example, the first 
file may be a directory file with names and file locations of the 
following files. Or the entire tape may contain only 1 file, with 
directory information stored in the initial block or blocks. 

The files themselves may have intrinsic formats. Card images 
may contain null-padded or blank-padded 80 byte records. 
Use the scrolling and paging facilities and the arbitrary block 
and file reads to examine the tape's data. After determining 
format, you can use depot or depot2 to read and translate 
it. 

Example 2; Checking the integrity of a tape. 

Using fddmp is a quick way to check the contents of a tape. 
Again, remove the write enable ring, mount the tape in the 
drive, boot DOS, and call program fddmp. fddmp immediately 
reads the first data block. If the data is in ASCII, you do not 
need to toggle the ASCII-EBCDIC switch. Page through the 
block, visually inspecting the data for correctness. Read 
subsequent blocks and files as needed. 

This method is not meant to verify data correctness. It is simply 
a quick method for checking overall contents. 

Example 3; Troubleshooting a tape problem. 

If you use another utility to read a tape, but the data is not 
correct or the tape does not seem to be readable, fddmp may 
help locate the problem. Load the tape and call fddmp as 
before, fddmp immediately reads the first data block. If the 
tape is readable, but the data is not correct, press (FT) to 
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examine the status word. If Bit 15 (parity error) is true, check 
cables between the controller and the drive. Bit or bits in error 
(in your data) may contain clues about which cable lines or 
channels are bad. The least significant bit corresponds to tape 
channel 7. 

Mount another tape (remember to remove the write enable 
ring) to determine if the tape itself is faulty. If other tapes also 
have problems, run the xtest program (using a scratch tape) 
to gather further diagnostic information. 

Example 4: Debugging a custom tape utility program. 

You can use fdump to help debug your own tape utility 
program. For example, when you're ready to test your 
program, mount your test tape and write your testing 
information to tape. Now call fdump to examine it (block by 
block if desired), fdump will tell you the length of each block, how 
many blocks in a file, and the positions of the filemarks. 

Use dD to read successive blocks. Note their length and the 
block number from the beginning of file. Also note the file 
number. As fdump reads each block, you may page through its 
contents as necessary. At the end of the file, fdump clearly 
indicates that it read a filemark, and the file number and block 
number reflect this status. Continue through the tape, 
examining its contents until you're convinced your tape utility is 
operating correctly. 

Limitations 

FDUMP has the following limitation: 

Maximum data block size is 65,000 bytes. 
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LABEL 

LABEL creates IBM and ANSI Standard Labeled Tapes, 
supporting Level 1 of these standards. Level 1 includes: 

Files: single-file single volume or single-file multivolume tapes. 

Labels: VOLl, HDRI, HDR2, EOVl, EOV2, EOFl, and EOF2. 

ANSI does not require HDR2, EOV2, and EOF2 for Level 1. 

LABEL writes these optional labels. It is allowable to write 
additional labels, since a Level 1 system ignores and bypasses 
any labels it does not process. The IBM Standard requires these 
labels. 

Record/Block Structures: Blocks consist of one or more fixed- 
length records. For non-character data files, we also support 
undefined record format. 

LABEL supports multi-file volumes for both ANSI and IBM labels. 

Use 

Find a blank tape, insert a write enable ring, and load it onto 
the drive. This procedure will write to tape; make sure the tape 
you choose has nothing important written on it. 

When the tape is loaded, place the drive online. Type: 


C:\> label (ENTER) 

LABEL displays the following main menu: 


Tape Label Writing Prograa 

Uersion Z.Z 3/16/88 Cc) 1987 Overland Data. Inc. 

SERIAL NO 8eZ075?5 

A) 

ANSI Ubel 

I) 

IBN Label 

Q) 

Quit 


Choose One -> 


Depending on whether you choose option a or i you will create 
an ANSI or IBM standard labeled tape. 


92 



Chapter 4—9-Track Tape Applications 


IBM Standard Labeled Tape 

An IBM Standard Labeled Tape consists of the following format: 
a header file (or label) followed by a filemark, the data file 
followed by a filemark, and a trailer file followed by two 
filemarks denoting the end of tape. 

When the data file does not fit onto a single tape reel, a slightly 
different trailer file is required, followed by a single filemark. The 
second and subsequent tapes contain three block header files 
(followed by a filemark), the data file (followed by a filemark), 
and the trailer file. The final tape ends with two filemarks. 
Volume Header Information 

The Header File consists of three 80-byte tape blocks. The first 
header label, VOL), is called Volume Header Information, label 
displays the following menu: 


Uolune Header Infomation 



Uolune ID 

[ooeeeii 

B) 

Owner ID 

[ 

C) 

Tape Reel Size 

[ 6001 

D) 

Tape Density 

[loeei 


H) Next Screen 
Q) Quit 



Type letter of iten you uant to change^ 
H (Tiext>« or Q (quit) —-> 


Volume ID 

(6 bytes.) A unique identification code assigned to your tape 
volume. The code is usually numeric characters (000001- 
999999), but may be any six alphanumeric characters. If you 
do not change this field, label uses the default 000001. 
Owner ID 

(10 bytes.) This field indicates a specific customer, person, 
installation, department, etc., to which the volume belongs. 
Any code or name is acceptable. If you do not change this field, 
LABEL uses blanks. 
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Tape Reel Size 

Specify the size of your tape reel. This field is not used in any 
header file. However, label uses this information to keep track 
of the amount of tape available for writing data. Providing 
inaccurate reel size will cause an unexpected end of file on tape. 
Tape Density 

Specify the recording density of your tape drive. The standard 
labels support tape densities of 800 bpi (bytes per inch), 1600 
bpi, and 6250 bpi. This information is also used to keep track of 
the amount of tape available for writing data. Providing 
inaccurate tape length data will cause an unexpected end of file 
on tape. 

Header 1 Information 

The second header block is HDRl, called Header 1 Information, 
displays the following menu: 



Header 1 Infornation 



A) 

Filenane on Disk 1 



1 

B) 

Dataset Identifier C 

1 



C) 

Creation Date [800001 




D) 

Expiration Date [000001 




E) 

Data Set Security [01 




F) 

Systen Code [ 1 

N) 

Q) 

Next Screen 

Quit 



Type letter of iten you want to changej 

N (next), or Q (quit) -> 



Filename on Disk 

Type in the name of the DOS file you want to put on tape. 

LABEL tries to open the file for reading. If unsuccessful, it 
displays an error message. You must enter data for this field 
before proceeding to the next screen. 

Dataset Identifier 

(17 bytes) Specify the dataset name for the HDRl label. This 
will be the file name of your data on the labeled tape. You must 
enter data for this field before proceeding to the next screen. 
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Creation Date 

Specify the year and day of the year when the data set was 
created. IBM uses the format yyddd where yy is the 2-digit year 
and ddd is the 3-digit day of the year, label uses the default 
00000 if you do not change this field. 

Expiration Date 

Specify the year and day of the year when the data set may be 
scratched or overwritten. IBM uses the format yyddd where yy 
is the 2-digit year and ddd is the 3-digit day of the year, label 
uses the default 00000 (meaning the dataset on tape is expired 
and may be overwritten) if you do not change this field. Use a 
date in the future to protect your tape data from destruction. 
Data Set Security 

(1 byte) Specify the code indicating the security status of the 
data set as follows: 

0 No password protection. 

1 Password protection. Additional identification of the data 
set is required before it can be read, written, or deleted. 

3 Additional identification of the data set is required before it 
can be read, written, or deleted. 

LABEL uses the default 0 (no protection) if you do not change 
this. 

System Code 

(] 3 bytes) Specify a unique code that identifies your system. 

This field is not used or verified when processing labeled tapes. 
LABEL uses all blanks if you do not change this field. 

Header 2 Information. 

The third header block is HDR2 called Header 2 Information. 
LABEL displays the following menu: 
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Header 2 Infomation 


A) 

Block Length 

[oooeei 


B) 

Becord Length 

[oooeei 


C) 

Job Step ID 

£ 

1 

D) 

Control Characters I 1 



HI Next Screen 
qi quit 

lijpe letter of Iten you uant to change, 
H (next), or q (quit) -> 


Specify the block length which your data file will be written in, in 
bytes. You must specify a field value before continuing. The 
block length (see next field) must be an even multiple of the 
record length. 

Record Length 

Specify the record length in bytes in which your data file will be 
written to tape. You must specify a value for this field before 
proceeding to the next screen. The block length must be an 
even multiple of the record length. 

Note; Your disk file will be read a line at a time and the 
carriage return - linefeed delimiters removed. Also, each line will 
be padded with blanks to the record size you specify. If you do 
not want this type of processing, specify; 

B) Remove CRLF Delimiters [NO] 

in the next menu. In this case, you should make the record size 

the same as the block size. 

Job Step ID 

(17 bytes) Specify the job step identification. If you do not 
change this field, label uses blanks. 

Control Characters 

If your file contains ASCII or Machine control characters, specify 
A (for ASCII) or M (for Machine). A blank means that your file 
contains no control characters. 
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Write IBM Labeled Tape. 

Before actually writing the tape, you may change some 
processing options for label. They are: 

1. Translating the data to EBCDIC 

2. Removing CRLF delimiters and padding to specified record 
size 

LABEL displays the following menu: 

Hrlte IM Ubeled Tape 


A) Translate DATA to EBCDIC [VESl 

B) Renoue CRLF Deliniters [VESl 


U) Urite Tape 

H) Next Screen 
Q) Quit 


Type letter of iten you uant# 
H (next)« or Q (quit) -> 


Translate Data to EBCDIC 

If your file is character data, you will want to translate it to the 
EBCDIC character set. If your file is binary data and you do not 
want it translated to EBCDIC, disable the translation. 

Notes: 

This is separate from removing CRLF delimiters. To disable 
CRLF processing, disable option (remove CRLF delimiters). 

This applies to data only. To write ASCII headers and trailers, 
you must use the ANSI Label Standard (see the Main Menu). 
Choose item A to toggle between options YES and NO. The 
default for this field is YES (translation takes place). 

Remove CRLF Delimiters 

If enabled, label reads your file a line at a time, removes the 
CRLF delimiters, and pads each line with blanks to the record 
size. If your file is binary data and you do not want this line-by- 
line processing, disable the Remove CRLF Delimiters option. 
When disabled, label reads your file in blocks and simply writes 
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it to tape with no processing. Also, when disabled label 
ignores the record size specified and makes it the same as the 
block size. The record format is still fixed (F). 

Note; This item is separate from data translation to EBCDIC. 
To disable translation to EBCDIC, disable option (Translate 
DATA to EBCDIC). 

Choose item B to toggle between options YES and NO. The 
default for this field is YES (remove CRLF delimiters). 

Write Tape 

When finished entering data for the program, type w to write. 

Note: We recommend you first check all options by reviewing 
each menu before writing tape. Press n to view each screen 
until LABEL returns to the Write IBM Labeled Tape menu. 

LABEL reports the number of blocks (excluding headers and 
trailers) it wrote to tape. If the data requires more than one 
tape, LABEL writes the trailers to tape and prompts for a new 
tape. 

End of File Processing 

When LABEL finishes writing the current file to tape, it asks you 
if you want to write another file, label will display this menu: 


End of File Processing 

Cnrrent Filenajne: \M7FILB.13AT ] 

Do yom 'vnnt lo 'viite onoUker tope (TIN)? I ] 


Press Y if you have another file to write to tape, label then 
returns to the Header 1, Header 2, and Write Tape Menus to 
obtain new information. You need only change the parameters 
that are different since label saves the values from the current 
tape data set. Press N if you want to stop. 

ANSI Standard Labeled Tape 

An ANSI Standard Labeled Tape is the same as an IBM standard 
labeled tape, except for the following items: 

■ Header information is recorded in ASCII. 

■ The Owner ID Field consists of 14 bytes instead of 10. 

■ No option is provided for translating the data to EBCDIC. 
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■ End of volume processing requires two filemarks after the 
final EOV trailer; IBM end of volume requires only one 
filemark. 

• HDR2, EOV2, and EOF2 labels are optional, iabel writes 
these to tape. 

Each of the ANSI menus is clearly labeled ANSI. 
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TAPEUTL 

This section contains complete instructions for running all the 
programs included in tapeutl. Each program is covered 
separately. The manual follows the main menu order (unlabeled 
tape, labeled tape, etc.) with each submenu choice covered in 
sequence within each section (disk-to-tape, tape-to-disk, etc.). 

If you want to use 9-track tape by writing a program in a high 
level language or in assembly language. Appendix A contains 
information on using the tape functions available through our 
device driver from programs written in C, BASIC, COBOL, 

FORTRAN or assembly language. 

The DOS filter function allows you to translate the data stream 
during transfers between disk and tape according to 
statements in a user-created translation file. 

Automatic-mode execution of tapeutl under control of a 
command file allows you to capture a tapeutl session and 
'replay' the same sequence of commands later. 

TAPEUTL 

The main program in the Tape Utility package is tapeutl . exe. 

To run this program, simply type its name at the DOS command 
prompt; 

C:> 'tapeu'tl 

When the program is loaded the first of a number of help 
screens will be displayed. At this point you can either start the 
program proper by hitting any alphanumeric key or you can 
page through the help screens by using the (pgDp) and (pgdn) 
keys. You may want to do this the first time you run tapeutl 
to familiarize yourself with the help facility. 

The first thing tapeutl does before displaying the first screen is 
find the amount of system memory available to determine if 
there is enough space for its own buffers. If the available 
memory is insufficient tapeutl will display a message saying so 
and stop. If this happens you will at the minimum need to 
reconfigure the system software on your machine. If your 
system needs more memory you may have to install more 
physical memory to run tapeutl. Check the following: 

■ Do you have memory-resident programs installed? Such 
programs reduce the amount of memory available to other 
programs: reboot without them and retry tapeutl. 
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■ Some print spoolers and RAM-disks such as VDISK also use 
system memory: remove the device's statement from your 
system's CONFIG.SYS file, reboot, then retry TAPEUTL. 
(NOTE: if the device uses extended memory on an auxiliary 
plug-in board then it will not interfere with tapeutl.) 

When you start tapeutl the main menu screen is displayed 
with a list of submenus you can choose from (Figure 1). Note 
that all TAPEUTL screens (except the tape block display 
screen) follow the general format: current submenu stays on 
the top half of the screen while particular options for the 
operation currently being done appear on the bottom half. 
The tape display screen is described separately below. 

To perform a tape function choose the submenu from the main 
menu (type its letter) then choose the desired function from the 
submenu. Many functions (e.g., file transfer to/from tape) will 
present fields on the lower hall of the screen (e.g., filenames and 
record lengths) which you fill in; when all necessary fields have 
been filled in press (enter) to start the function. To move from 
field to field use (r^ (the key with two arrows on it on IBM 
keyboards) to move forward and (shiri + H^ to move 
backward. To cancel a function, (esc) will always put you back at 
the menu you came from without performing the function 
(think of (ESC) as a user's panic button). If you are at the MAIN 
menu (Isc) will end the program and return you to DOS. 


Flagstaff Engineering Tape Utility Program 

A) Process unlabeled tapes 

B) Process labeled tapes 

»» Main «« 

C) Reposition tape or display records 

Unlabeled Tape 

D) Cfiange tape system parameters 

Labeled Tape 

E) Initialize DOS filter 

Position/Display 

Change Parameters 

Command: 

Initialize Filter 

-<F10 = Help ESC = 

Exit Routine>- 


FIGURE 1. Main Menu 


Processing Unlabeled Tapes 

When the unlabeled tape option is chosen from the main menu 
the following submenu is displayed: 
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Flagstaff Engineering Tape Utility Program 


A) Copy from disk to tape 

B) Copy from tape to disk 

Main 

C) Reposition tape or display records 

»»Unlabeled Tape «<- 

D) Copy multiple files from tape to disk 

Labeled tape 

E) Summarize Tape Data 

Position/Display 

Command: 

Change Parameters 

Initialize Filter 

-<P10 = Help ESC = Exit Routine>- 


FIGURE 2. Unlabeled Tape Submenu 


Although this option is primarily intended for handling unlabeled 
tapes it can be used to transfer data from labeled tapes if the 
user uses caution. This option should not be used to transfer 
data to labeled tape as no labels are written by the transfer 
routines. 

The exception to this rule is if certain system specific labels need 
to be written on a tape; in which case the labels are written as 
separate files preceding and/or following the actual data file. In 
such a case we recommend that the user consult a system 
programmer familiar with the target system label format. 

Copy from Disk to Tape 

Use this option to copy data from a DOS (disk) file to unlabeled 
tape at the current tape position. Unlike the labeled tape 
disk-to-tape transfer this operation is always carried out at the 
current tape position. The tape must be correctly positioned 
before this operation is started; use the Reposition tape or 
display records option on this submenu if the tape is not where 
you want it. 

Initially the following three or four fields will appear at the 
bottom half of the screen: 

Input file name: this is the fully-qualified name of the DOS disk 
file. A wildcard DOS file name may be given for unlabeled tapes. 

If just a normal wildcard file name is given each input file will 
create a separate output file on tape. (On labeled tapes each 
tape file name will be the same as input DOS file name.) If a "-i-" 
is placed immediately after the wildcard name then all wildcard 
files will be concatenated into one file on the tape. 


103 








Chapter 4—9-Track Tape Applications 


Translate data? Three choices are possible: 

N - no translation 

A - data will be translated from EBCDIC to ASCII 

E - data w>\\ be trans\aieci from ASCW to EBCD\C. 

Data type; this specifies how the incoming data is to be treated. 
Since data on tape is always written in blocks the entry in this 
field will control how the disk file data is broken up into these 
tape blocks. There are three (3) possibilities; 

1 Fixed-length records: data is read from the disk file as 
records of a specified length (given by the user). The disk 
data is not scanned for line-end characters or other 
delimiters but is assumed to be divided into logical records of 
the user-specified length. 

2 Variable-length records: the disk file data is assumed to be in 
logical records of varying length; each record terminated by 
an identical character sequence. With this type of transfer 
data is read from disk as variable-length but written to tape 
as fixed-length records (short records are padded). 

3 String data; this option is used in the case where the disk 
data file is not divided into logical records at all (e.g., an 
executable program file that consists of binary data). The 
disk data is treated as a continuous string of data. The tape 
file is divided into blocks but the blocks are simply fixed-length 
chunks of the input file with a possible short last block. 

Filter on (N/Y): this field will only appear if the translation filter 
has been initialized from the main menu. If Y(es) is specified, data 
from the input file is translated according to statements in the 
filter file before being written to tape. The default (predicted) 
value here is N(o). See the section on the DOS filter function 
starting on page 144 for more information. 

Depending on the data type chosen for the transfer additional 
fields will appear Complete screens for each data type are 
shown next with a description of the remaining fields. 
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Fixed-Length Data Transfer 


-<F10.= Help ESC.= Exit Routine>- 

<DiskOTape> 

Input file name \customer\sales.dta 


Translate data? (N=no A=EBCDIC to ASCII E=ASCII to EBCDIC) N 

Data type; (F)ixed (V)ariable (S)tring f 

Record size 1024 

Records per output tape block 20 

Records to skip 0 

Records to transfer ALL 


File size 189952 bytes 

There is a partial record of 512 bytes: transfer it? y/n y 



Figure 3. Disk to unlabeled tape-fixed-length transfer fields. 


Four (4) additional fields appear for fixed-length transfer 
operations: 

1 Record size: this specifies the length of each logical record in 
the disk file. Remember that tapeutl doesn't do any kind of 
checking on the input records but assumes that the input 
records are in fact this length. If you're not sure what length 
the file records are look at the file first with a file 
dump/display utility (e.g., the DFILE program) to determine 
the proper record size. 

2 Records per output tape block: this is the blocking factors to 
be used on tape. This number multiplied by the record length 
gives the tape block size in bytes which can be a maximum of 
65,536 bytes. If this size is exceeded the program will display 
a warning message and you will be asked to change either 
the record size or the number of records per block. 

3 Records to skip: this field pre-filled with zero specifies an 
optional number of records from the input file to be skipped 
before the data transfer to tape starts. 

4 Records to transfer: this field pre-filled with ALL specifies an 
optional limit on the number of records to be transferred to 
tape. If only a certain number of records are to be copied, 
enter the number in this field. 

When a fixed-length transfer is started tapeutl gets the size of 
the input file from the disk directory displays it and compares 
this size to the record size to determine whether there will be a 
short record at the end of the file if there is a message will 
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appear at the bottom of the screen asking if you want to 
transfer this partial record. Answering Y will cause this last 
record to be padded with binary zeros (0) at the end of the file; 
answering N will simply drop this last record from the tape file. 
There will usually be a short block at the end of a fixed-length 
blocked record file (when writing out fixed length records and if 
file size is not a multiple of the record size the operator is still 
asked if he/she wants to truncate the partial record). 

After the transfer is complete the number of tape blocks, 
number of logical records and number of bytes in the tape file 
will be displayed. A prompt will appear at the bottom of the 
screen asking if you want to append another file to this one; see 
Appending Files on Tape, below, for an explanation of this 
choice. To transfer another file simply hit 
(ENTER) at this point. This will close the tape file by writing 
filemarks after the last block and prepare you for writing 
another new file after this one. Press (H© to return to the 
unlabeled tape submenu. 

Variable-Length Data Transfer __ 

-<F10.= Help ESC.= Exit Routine>- 

<DiskTape> 

Input file name \text\letter1 .doc 

Translate data? (N=no A=EBCDlC to ASCII E=ASCII to EBCDIC) N 
Data type: (F)ixed (\/)ariable (S)tring v 
Record size 60 

Records per output tape block 1000 
Records to skip O 
Records to transfer ALL 
Line delimiter ODOA 
Pad character 20 

File size 48182 bytes 
Data transfer in progress... 

Figure 4. Disk to unlabeled tape-variable-length transfer fields. 

Six additional fields appear when a variable-length transfer is 
chosen: 

1. Record size; this is the size of the tape (output) record which 
is the size of the largest record in the file not including line 
delimiter characters. Remember that variable-length only 
applies to the disk (input) file; the tape file is written as 
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fixed-length records. If a record is shorter than the given 
record size it is right-filled with pad characters (see below), if 
a record is bigger than this size it will be split—^the excess 
part will be written as a new record—and a warning 
message will be displayed after the transfer; 

WARNING! nn records exceeded specified length 
If this happens try the transfer again with a larger record 
size. No data will be lost in any case but the file may need to 
be reformatted to restore lines to their original form. 

2. Records per output tape block; this is the blocking factor to 
be used on tape. This value multiplied by the record length 
gives the tape block size in bytes which can be a maximum of 
65,536 bytes. If this size is exceeded the program will display 
a warning message and you will be asked to change either 
the record size or the number of records per block. 

3. Records to skip; this field pre-filled with zero specifies an 
optional number of records from the input file to be skipped 
before the data transfer to tape starts. 

4. Records to transfer; this field pre-filled with ALL specifies an 
optional limit on the number of records to be transferred to 
tape. If only a certain number of records are to be copied 
enter the number in this field. 

5. Line delimiter; this specifies which character or string of 
characters are to be taken as an end-of-line marker in the 
input file. This entry must correspond to the actual line 
delimiters in the file for the transfer to be successful. The 
characters (up to 10) are specified as 2-digit hexadecimal 
values with the most common values pre-filled; OD OAor ASCII 
carriage-return and line-feed characters. 

CAUTION! See the section on the DOS filter function starting 
on page 144 for an explanation of pitfalls to avoid if you are 
using a translation filter. 

5. Pad character; the character which will be used to fill short 
records is specified here as a 2-digit hexadecimal value. This 
field is pre-filled with a commonly-used fill character the ASCII 
space (hex 20). The EBCDIC space character is hex 40. 

The variable-length data transfer works like this; as the input file 
is read from disk TAPEUTL continually scans the data for the 
specified line delimiter characters. When the delimiter string is 
found the record is filled out to the specified record length with 
pad characters if necessary, then written to tape. The line 
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delimiters themselves are not transferred but they can be 
restored by the corresponding tape-to-disk transfer routines. If 
a record exceeds the specified length it is split as explained above 
in the Record size field description and a count of all such records 
is kept and displayed after the transfer operation. 

After the transfer is complete the number of tape blocks 
number of logical records and number of bytes in the tape file 
will be displayed. A prompt will appear at the bottom of the 
screen asking if you want to append another file to this one; see 
Appending Files on Tape below for an explanation of this choice. 
To transfer another file simply hit (enter) at this point; this will 
close the tape file just written by writing filemarks after the last 
block and prepare you for writing another new file after this 
one. Press to return to the unlabeled tape submenu. 


String Data Transfer 


-<F10.= Help ESC.= Exit Routine>- 

<Disk0Tape> 

Input file name \binary\prog1.exe 


Translate data? (N=no A=EBCDIC to ASCII E=ASCII to EBCDIC) N 

Datatype: (F)ixed (V)ariable (S)tring S 

Output tape block size 60000 

Characters to skip 0 

Characters to transfer ALL 


Terminate on EOF (X’lA') character N 


4 blocks 189952 bytes copied 


Do vou wish to append another DOS file? (n/y) n 



Figure 5. Disk to unlabeled tape-string transfer fields. 

When a string-data transfer is chosen four (4) additional fields 
appear on the lower half of the screen: 


1. Output tape block size; this specifies the actual tape block size 
to be written up to 65 536 bytes. 

2. Characters to skip: this field pre-filled with zero specifies an 
optional number of characters to be skipped before the data 
transfer to tape starts. 

3. Characters to transfer: this field pre-filled with ALL specifies 
an optional limit on how many characters to transfer to 
tape. If the limit is needed enter the number of characters in 
this field. 
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4. Terminate on EOF (X'lA'j character? If the data to be 
transferred is in a normal ASCII text file this option can be 
chosen (by entering Y) to end the transfer on the 
conventional ASCII end-of-file character (hexadecimal 1 A 
decimal 26 also known as Control-Z). This option should not 
be chosen (by entering N ) if so-called binary data is to be 
transferred (i.e. executable programs binary image data 
etc.) because such data is likely to contain many hex 1 A 
characters which would falsely be interpreted as end-of-file. 
Copy from Tape to Disk 

Use this option to copy a file from tape at the current tape 
position to a disk file. Unlike the labeled tape tape-to-disk 
transfer this operation is always carried out at the current tape 
position. The tape must be correctly positioned before this 
operation is started; use the Reposition tape or display records 
option on this submenu if the tape is not where you want it. 
Initially the following three or four fields will appear at the 
bottom half of the screen: 

Output DOS file name: this is the fully-qualified name of the DOS 
disk file which will be written which must include any necessary 
drive letters and pathnames to identify the file (for example 
B:\text\letterl .doc). 

Translate data? Three (3) choices are possible: 

N - no translation 

A - data will be translated from EBCDIC to ASCII 

E - data will be translated from ASCII to EBCDIC. 
Data type: this specifies how the incoming data from tape will 
be treated when transferring it to disk. There are four choices: 

1 Fixed-length records: the tape file is assumed to be divided 
into equal-length records of a size given by the user. These 
logical records are simply copied from the tape blocks to the 
disk file as they are read. No line delimiters are read or 
written. 

2 Variable-length records: this really means variable-length 
physical blocks on tape. Each block in the tape file is treated 
as a separate logical record and these blocks can vary in size. 
In transferring these blocks to disk file records line-end 
delimiters (e.g. carriage-return/line feed pairs) can be added 
to the end of each record to produce a valid ASCII-type file— 
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that is, a file that can be successfully displayed using the 
TYPE command or printed on a line printer. 

3 IBM Variable-length records; this is a special type of variable 
length record where each logical record has a 4-byte prefix 
which contains a binary count of characters in the record. 
This count is contained in the first word (2 bytes) of the 
prefix and the second word of the prefix is usually binary 
zero. This option is generally only used when transferring files 
from tapes written on IBM mainframe computer systems . 

4 String data: this option is used in the case where the tape file 
is not divided into logical records at all (for example an 
executable program file which consists of binary data). The 
tape data is treated as a continuous string of data. The tape 
file is divided into blocks but the blocks are simply fixed length 
chunks of the input file with a possible short last block. All 
tape data is transferred to disk contiguously (no breaks). 

Filter on (N/Y): this field will only appear if the translation filter 
has been initialized from the main menu. If Y(es) is specified data 
from the tape is translated according to statements in the filter 
file before being written to the disk file. The default (pre-filled) 
value here is N(o). See the section on the DOS filter function 
starting on page 144 for more information. Regardless of the 
type of data transfer chosen TAPEUTL will search for the given 
output disk file to see if one already exists. If it does the following 
message will appear; 

DOS file already exists -do you want to erase old file (Y/N)? 

If you answer Y at this point the existing file will be replaced and 
all data currently in the file will be lost. If you answer N the 
transfer will not start until you hit (enter) again giving you an 
opportunity to change the output file name. 

If the target volume (fixed disk or diskette) that the file is being 
copied to becomes full during the transfer operation the 
transfer will be suspended and the following message will 
appear at the bottom of the screen (Note: Output breaks at a 
record boundary when the output DOS volume becomes full): 

DOS volume full-new file name (ESC to abort) 

If you want to continue the transfer you will need to enter the 
name of the file which will contain the next part of the tape file 
including any needed drive letter and pathname specifiers. The 
transfer will resume with the next (I byte (character) of the tape 
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file on the new disk file. To end the transfer hit (esc) ; the data on 
the full disk volume will be retained and you will return to the 
unlabeled tape submenu. 

Depending on the data type chosen for the transfer additional 
fields will appear below these fields. The complete screens for 
each data type are shown next with a description of the 
remaining fields. 

1. Pad character; used in conjunction with the preceding option 
this specifies the pad character to be (optionally) stripped 
from the output record. This entry is specified as a 2-digit 
hexadecimal value corresponding to a single character and is 
pre-filled with the most common pad character the ASCII 
space (hex 20). 

2. Insert line end? this field and the next set options that allow 
a tape file of fixed-length records to be written to disk as a 
file of variable-length records with line-end delimiters. If Y is 
chosen here then each logical record from tape will have 
line-end delimiters appended in the output record. By 
appending delimiters the file will be essentially a normal ASCII 
text-type file (assuming that the data is ASCII text). 

3. Line end characters (In hex): in conjunction with the 
preceding field this specifies the line-end characters to be 
appended to each output record it Insert line end is chosen. 
These characters (up to 10) are specified as 2-digit 
hexadecimal values. The field is pre-filled with the most 
common line delimiters (carriage-return, line-feed characters 
(hex OD-OA decimal 13-10)). 

4. Records to skip: this field pre-filled with zero specifies an 
optional number of records from the input file to be skipped 
before the data transfer to tape starts. 

5. Records to transfer; this field pre-filled with ALL specifies an 
optional limit on the number of records to be transferred to 
tape. If only a certain number of records are to be copied 
enter the number in this field. 

After the transfer is completed a message will appear stating 
the number of records transferred. Alter clearing this message 
you can start another tape-to-disk transfer by filling in the 
appropriate fields and hitting (enter) : the tape will be positioned 
at the start of the next file. Hit fisc) to exit to the unlabeled 
tape submenu in order to reposition the tape etc. 
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Variable-Length Data Transfer _ 

-<F10.= Help ESC.= Exit Routine>- 

Maximum block . 16384 <TapeODisk> 

output DOS file \temp\junk1 .out 

Translate data? (N=no A EBCDIC to ASCII E=ASCI1 to EBCDIC) N 
Datatype: (F)ixed (V)ariable (l)BM variable (S)tring v 

Record length 1000 

Strip trailing pad characters (Y/N) N Pad character 20 

Insert line end (Y/N) y 

Line end characters (in hex) OD OA 

Records to skip 0 

Records to transfer ALL 

Copy complete - 60 records, 57313 bytes - press any key to continue. 
FIGURE 7. Unlabeled tape to disk-variable-length transfer fields. 

When transferring data from tape to disk the term “variable 
length record" has a completely different meaning than the 
usual sense of variable-length logical records in a disk file. Keep in 
mind that all data on tape is written in blocks. All the blocks that 
make up a tape file do not have to be the same size. From the 
tape’s point of view these blocks look like records since they must 
be treated as contiguous chunks (the tape drive cannot stop 
reading or writing in the middle of a block). Hence variable 
length records for tape really means variable-length blocks. 

All of this is to caution that it is easy to become confused about 
tape blocks and records. The variable-length unlabeled 
tape-to-disk transfer option is provided for unusual data 
transfer needs where each tape record (block) needs to be 
written to disk as a separate logical record with the options of 
stripping trailing pad characters and adding line-end delimiters 
to each output record. 

If you are transferring a tape file to disk that was originally 
written by TAPEUTL (or some other source) from a file of 
variable-length records you probably need to use the 
fixed-length transfer option above. This can reconstruct the file 
in its original form including proper record length and line-end 
delimiters (assuming that no records were split during the 
disk-to-tape transfer). 

IBM Variable-Length Record Transfer _ 

---<F10.= Help ESC.= Exit Routine>- 
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Maximum block. 16384 <TapeODisk> 

Output DOS file \temp\junk2.out 

Translate data? (N=no A=EBCDIC to ASCII E-ASCII to EBCDIC) N 
Data type: (F)ixed (V)ariable (l)BM variable (S)tring i 

Record length 50 

Strip trailing pad characters (Y/N) N Pad character 20 

Insert line end (Y/N) y 

Line end characters (in hex) OD OA 

Records to ship 0 

Records to transfer ALL 

Copy complete - 99 records 3997 bytes - press any key to continue: 
FIGURE 8 Unlabeled tape to disk-IBM variable-length transfer fields. 

Files containing IBM variable-length records consist of blocks 
which are prefixed by a 4-byte block length header. This header 
contains the total number of bytes in the block including the 
header. Each record is prefixed by a 4-byte record length 
header containing the number of bytes in the record including 
the header. The file and header layouts are shown below. 


IBM VARIABLE-LENGTH RECORD LAYOUTS 


block length 

record 1 

record 1 

record 2 

record 2 

header 

header 

data 

header 

data 


Figure 9. IBM Variable-length Record File Block Structure. 


length 

length 

binary 

binary 

count MSB 

count LSB 

zero 

zero 


Figure 10. IBM Variable-length Record Block/Record Header Fields. 

Both block and record headers are 4 bytes (2 words) long with 
the block or byte count in the first word with the 
most-significant byte (MSB) first least-significant byte (LSB) 
second. This is the opposite of how the IBM PC stores binary 
words in memory. The second word of the header should 
always be zero (NOT the ASCII character to I). Remember that 
both the block and record length headers include their own 
length so that these counts are actually 4 greater than the 
actual block or record length. 

The additional fields that appear on the bottom half of the 
screen for this type of transfer are the same as for simple 
variable-length record transfers. See the preceding section for a 
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detailed description of these fields and of the transfer 
operation. 

String Data Transfer _ 

-<F10.= Help ESC.= Exit Routine>- 

Maximum block 16384 <TapeODisk> 

Output DOS file \temp\string.dta 

Translate data? (N=no A=EBCDlC to ASCII E=ASCII to EBCDIC) N 
Datatype: (F)ixed (V)ariable (l)BM variable (S)tring S 

Characters to skip 0 
Characters to transfer ALL 

Copy complete -189952 bytes transferred - press any key to continue: 
FIGURE 11. Unlabeled tape to disk-string data transfer fields. 

The unlabeled tape-to-disk transfer operation works the same 
way as a string transfer going from disk to tape data is simply 
transferred byte-for-byte from tape and written out to the 
output disk file. Differing block sizes have no effect on the data 
transfer and data is neither read nor written as logical records 
but as one continuous string of data. 

When a string tape-to-disk transfer is chosen two additional 
fields appear on the bottom half of the screen; 

1. Characters to skip; this field pre-filled with zero specifies an 
optional number of characters to be skipped before the data 
transfer to tape 

starts. 

2. Characters to transfer; this field pre-filled with ALL specifies 
an optional limit on how many characters to transfer to 
tape. If such a limit is needed enter the number of characters 
in this field. 

Reposition Tape or Display Records 

This option chosen from the unlabeled tape submenu is exactly 
the same as the option of the same name on the main menu; 
see the section describing this option starting on page 134. 

Copy Multiple Files from Tape to Disk 

Option D is provided to allow you to concatenate multiple tape 
files into a single disk file. This is similar to what happens in the 
opposite direction—disk to tape-when you append a disk file to 
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a file that has been copied to tape but not yet closed. The 
specified number of files are read from tape and all the data 
goes into one disk file. 

The multiple-file tape-to-disk transfer operations use the same 
additional fields as the single-file tape-to-disk transfers; for a 
particular type of transfer (for example variable-length records) 
see the appropriate section above. When multiple-file transfer is 
specified there is one additional field that appears near the 
bottom of the screen for all data types: 

1. Number of files to transfer: this field pre-filled v\/ith the value 
ALL specifies the number of files to be transferred starting 
at the current tape position. If the logical end-of-tape (two 
successive filemarks) is found before this number of files is 
transferred the operation is ended and the disk file closed. 
When replacing the value in this field be sure to overtype all 3 
characters in the field using spaces if less than 3 digits are 
given. 

Summarize Tape Data 

This option has been added to the unlabeled menu which allows 
users to read from the beginning of the tape to the logical end 
of the tape and summarize each file. A file is defined as data 
delimited by filemarks. These items are displayed for each file a) 
minimum block size found b) maximum block size found c) the 
number of blocks of data in the file and d) the total number of 
bytes in the file. 

Processing Labeled Tapes 

Before using the labeled tape operations you should be familiar 
with the basic concepts of labeled tape formats and processing. 
Read Chapter 1 of this manual for more information. 

When the labeled tape option is chosen from the main menu the 
following submenu appears and stays on the top half of the 
screen throughout all labeled tape operations: 
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■ unlike the directory on a disk or diskette it is possible to 
have non-unique filenames on a tape. If there is more 
than one file with the same name on a labeled tape and 
you specify that file by name TAPEUTL will always find the 
first file and never find the second file. To position to files 
with identical names you must use the position-by¬ 
sequence number option. 

■ whenever you exit the labeled tape submenu and later 
re-enter it TAPEUTL always reinitializes the tape position 
by rewinding if necessary then positioning just past the 
volume label. Be aware of this if you need to go to 
another submenu (for example if you want to display a 
tape block) because the current position may no longer 
be where you think it should be. 




Flagstaff Engineering Tape Utility Program 

A) Copy file from disk to tape 


B) Copy file from tape to disk 

Main 

C) List files on the tape 

Unlabeled Tape 

D) Initialize volume label 

»»Labeled T ape «« 

E) Switch OS/DOS label type 

Label Type OS/DOS 


Change Parameters 

Command: a 

Initialize Filter 

<FlO.Help ESC 

Exit Routine> 


<DiskOTape> 

Tape position (C)urrent/file#/filename/(E)nd C 

Input file name \tape\file001.dta 

Tape name File# 1 

Translate data? (N=no A=EBCDIC to ASCII E=ASCII to EBCDIC) N 

Data type; (F)ixed (V)ariable (S)tring S Filter on (NAT) N 


Figure 13. Labeled tape submenu-common disk-to-tape fields. 


This option is used to create a tape file from data read from a 
disk file or files with header and EOF labels automatically written 
before and after the tape file (see Chapter 2 for a discussion of 
tape labels). 

When this option is first chosen from the labeled tape submenu 
the tape will automatically be positioned correctly to write the 
first file on the tape (just after the volume label). This is true 
whether or not there are any files on the tape. N there are 
existing files on the tape that need to be preserved you must 
reposition the tape to avoid overwriting this first file: see the 
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Tape position field description below for an explanation. DOS 
and OS labels as well as multivolume labeled input and output 
files are supported. 

DOS labels are essentially the same as OS labels except 
HDR2/EOV2/ EOF2 label records are not present. Therefore 
format record size and block size are unknowns. DOS labels also 
have a corresponding ANSI (ASCII) format. 

Initially the following five or six fields will appear on the bottom 
half of the screen: 

1. Tape position: this allows the tape to be repositioned before 
the diskto-tape transfer starts. There are four possible 
options: 

2. (C)urrent position: as one might guess this is simply where 
the tape already is. Keep in mind that this current position is 
at the beginning of the tape when the disk-to-tape option is 
first chosen from the labeled tape submenu (see above). C is 
the pre-filled default option. 

3. File #: by entering a number here tapeutl will look tor that 
file by sequence number on tape starting at the first file. If 
the file is found the tape will be positioned at the start of 
that file ready to start overwriting the file. If the number 
given is greater than the total number of files on the tape a 
File Not Found message will be displayed. 

4. Filename: if the name of a file is entered in this field tapeutl 
will attempt to locate a file with that name written in its 
HDRl label. If the file is found the tape will be positioned at 
the start of the.next file as described above; if no file by that 
name is found a File Not Found message will be displayed. 

5. Input file name: this is the fully-qualified name of the DOS disk 
file which must include any necessary drive letters and 
pathnames to identify the file (e.g., B:\textMetterl .doc). 

Translate data? Three (3) choices are possible: 

N - no translation 

A - data will be translated from EBCDIC to ASCII 

E - data will be translated from ASCII to EBCDIC. 

6. Data type: this specifies how the incoming data is to be 
treated. Since data on tape is always written in blocks the 
entry in this field will control how the disk file data is placed 
into the tape blocks. There are three (3) possibilities: 

■ Fixed-length records: data is read from the disk file as 
records of a specified length (given by the user). The disk 
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data is not scanned for line-end characters or other 
delimiters but is assumed to be divided into logical records 
of the user-specified length. 

■ Variable-length records: the disk file is assumed to be in 
logical records of varying length, each record terminated 
by an identical sequence of character(s). WIththis type of 
transfer, data is read from disk as variable-length but 
written to tape as fixed-length records (short records are 
padded out with a fill character). 

■ String data: this option is used in the case where the disk 
data file is not divided into logical records at all (e.g., an 
executable program file which consists of binary data). 
The disk data is treated as a continuous string of data. 
THe tape file is divided into blocks, but the blocks are simply 
fixed length chunks of the input file, with a possible short 
last block. 

7. Filter on (N/Y): this field will only appear if the translation 
filter has been initialized from the main menu. If Y(es) is 
specified, data from the input file is translated according to 
statments in the filter file before being written to tape. The 
default (pre-filled) value here is N(o). See the section on the 
DOS filter function on page 144 for more information. 
Depending on the data type chosen for the transfer, additional 
fileds will appear below these fields. The complete screenes for 
each data type are shown next, with a description of the 
remaining fields. 

Fixed-Length Data Transfer _ 

-<F10.= Help ESC.= Exit Routine>- 

DiskOTape> 

Tape position (C)urrent/file#/filename/(e)nd e 

Input file name \onfile\onfile.exe Tape name ramboloon 

Translate data? (N=no, A=EBCDIC to ASCII, E=ASCII to EBCDIC) N 

Data type: (F)ixed, (V)ariable, (S)tring f 

Record size 256 

Records per output tape block 100 
Records to skip 0 
Records to transfer ALL 

8 blocks 742 records 189952 bytes copied 

Do you wish to append another DOS file? (n/y): 

Figure 14. Disk to labeled tape-fixed-length transfer fields. 







Chapter 4—^9-Track Tape Applications 


Four additional fields appear for fixed-length transfer 
operations: 

1. Record size: this specifies the length of each logical record in 
the disk file. Remember that TAPEUTL doesn't perform any 
checking of the input records, but assumes that the input 
records are, in fact, this length. If you re not sure what 
length the file records are, look at the file first with a file 
dump/display utility (for example. Flagstaff Engineering's 
□FILE program) to determine the proper record size. 

2. Records per output tape block: this is the blocking factor to 
be used on tape. This number multiplied by the record length 
gives the tape block size in bytes, which can be a maximum of 
65,536 bytes (65,519 for the OD32IO). If this size is 
exceeded, the program will display a warning message and 
you will be asked to change either the record size or the 
number of records per block . 

3. Records to skip: this field, pre-filled with zero, specifies an 
optional number of records from the input file to be skipped 
before the data transfer to tape starts. 

4. Records to transfer: this field, pre-filled with ALU specifies an 
optional limit on the number of records to be transferred to 
tape, n only a certain number of records are to be copied, 
enter the number in this field. 

When a fixed-length transfer is started, TAPEUTL gets the size 
of the input file from the disk directory, displays it, and 
compares this size to the record size to determine whether or 
not there will be a short record at the end of the file, n there is, 
a message will appear at the bottom of the screen asking if you 
want to transfer this partial record. Answering Y will cause this 
last record to be padded with binary zeros (O) at the end of the 
file; answering N will simply drop this record from the tape file. 
There will usually be a short block at the end of a fixed-length, 
blocked record file. 

After the transfer is complete, the number of tape blocks, 
number of logical records and number of bytes in the tape file 
will be displayed. A prompt will appear at the bottom of the 
screen asking if you want to append another file to this one; see 
Appending Files on Tape below for an explanation of this choice. 
To transfer another file, simply hit (enter) at this point. This will 
close the tape file by writing EOF labels after the last block and 


120 



Chapter A —9-Track Tape Applications 


prepare you for writing another, new file after this one. Press 
(esc) to return to the labeled tape submenu. 

Variable-Length Data Transfer _ 

-<F10.= Help ESC.= Exit Routine>- 

<DiskOTape> 

Tape position (C)urrent/file#/filename/(e)nd C 

Input file name \doc\taputil2.asc Tape name databaiti I! 

Translate data? (N=no, A=EBCDIC to ASCII, E=ASCII to EBCDIC) N 
Data type: (F)ixed, (V)ariable, (S)tring v 
Record size 80 

Records per output tape block 200 
Records to skip 0 
Records to transfer ALL 
Line delimiter OD OA 
Pad character 20 

2 blocks 238 records 19040 bytes copied 

WARNING! 6 records exceeded specified length 
—press any key to continue: 

Figure 15. Disk to labeled tape-variable-length transfer fields. 

Six additional fields appear when a variable-length transfer is 
chosen: 

1. Record size: this is the size of the tape (output) record, which 
is the size of the largest record in the file not including line 
delimiter characters. Remember that variable-length only 
applies to the disk (input) file; the 2 blocks 238 records 19040 
bytes copied tape file is written as fixed-length records. If a 
record is shorter than the given record size, it is right-filled 
with pad characters (see below). If a record is longer than 
this size, it will be split-the excess part will be written as a 
new record-and a warning message will be displayed after 
the transfer: 

WARNING! nn records exceeded specified length 

If this happens, try the transfer again with a larger record 
size. No data will be lost in any case, but the file may need to 
be reformatted to restore lines to their original form. 

2. Records per output tape block: this is the blocking factor to 
be used on tape. This value multiplied by the record length 
gives the tape block size in bytes, which can be a maximum of 
65,536 bytes (65519 bytes for the OD32IO). If this size is 
exceeded, the program will display a warning message and 
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you will be asked to change either the record size or the 
number of records per block. 

3. Records to skip; this field, pre-filled with zero, specifies an 
optional number of records from the input file to be skipped 
before the data transfer to tape starts. 

4. Records to transfer: this field, pre-filled with ALL specifies an 
optional limit on the number of records to be transferred to 
tape, n only a certain number of records are to be copied, 
enter the number in this field. 

5. Line delimiter; this specifies which character or string of 
characters are to be taken as an end-of-line marker in the 
input file. This entry must correspond to the actual line 
delimiters in the file for the transfer to be successful. The 
characters (up to 10) are specified as 2-digit hexadecimal 
values, with the most common values pre-filled: ODOA, or 
ASCII carriage-return and line-feed characters. 

CAUTION! See the section on the DOS filter function starting 
on page 144 for an explanation of pitfalls to avoid if you are 
using a translation filter. 

6. Pad character; the character which will be used to fill short 
records is specified here as a 2-digit hexadecimal value. This 
field is pre-filled with a commonly-used fill character, the ASCII 
space (hex 20). The EBCDIC space character is hex 40. 

The variable-length data transfer works in this manner; as the 
input file is read from disk, TAPEUTL continually scans the data 
for the specified line delimiter characters. When the delimiter 
string is found, the record is filled out to the specified record 

length with pad characters if necessary, then written to tape. 
The line delimiters themselves are not transferred, but they can 

be restored by the corresponding tape-to-disk transfer routines, 
n a record exceeds the specified length. It Is split as explained 
above in the Record size field description, and a count of all such 
records is kept and displayed after the transfer operation. For a 
variable-length transfer, data remaining at the end of a file will 
always be written as a short block on tape if necessary. 

After the transfer is complete, the number of tape blocks, 
number of logical records and number of bytes in the tape file 
will be displayed. A prompt will appear at the bottom of the 
screen asking if you want to append another file to this one; see 
Appending Files on Tape below for an explanation of this choice. 
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To tr ansfer another file, simply hit (enter) at this point. Press 
(end) to return to the labeled tape submenu. 

String Data Transfer _ 

-<F10.= Help ESC.= Exit Routine>--- 

<DiskOTape> 

Tape position (C)urrent/file#/filename/(E)nd e 

Input file name \onfile\onfile.exe Tape name calafragilistic! 

Translate data? (N=no. A=EBCDIC to ASCII, E=ASCII to EBCDIC) N 

Data type: (F)ixed, (y)ariable, (S)tring S 

Output tape block size 32760 

Characters to skip 0 

Characters to transfer ALL 

Terminate on EOF (X’1 A’) character N 

6 blocks 139952 bytes copied 

Do you wish to append another CXDS file? (n/y): 

Figure 16. Disk to labeled tape-string data transfer fields. 

When a string-data transfer is chosen, four additional fields 
appear on the lower half of the screen: 

1. Output tape block size: this specifies the actual tape block size 
to be written, up to 65,536 bytes (65,519 bytes for the 
OD3210). 

2. Characters to skip: this field, pre-filled with zero, specifies an 
optional number of characters to be skipped before the data 
transfer to tape starts. 

3. Characters to transfer: this field pre-filled with ALL specifies 
an optional limit on how many characters to transfer to 
tape. If such a limit is needed enter the number of characters 
in this field. 

4. Terminate on EOF (X'lA') character? If the data to be 
transferred is in a normal ASCII text file this option can be 
chosen (by entering Y) to end the transfer on the 
conventional ASCII end-of-file character (hexadecimal lA 
decimal 26 also known as Control-Z). This option should not 
be chosen (by entering N ) in so-called binary data is to be 
transferred (i.e. executable programs image data, etc.) 
because such data is likely to contain many hex lA 
characters which would falsely be interpreted as end-of-file. 

A string data transfer will simply copy all the data from the disk 
file byte-for-byte to the tape file with no processing or alteration 


123 








Chapter 4—^9-Track Tape Applications 

unless translation between ASCII and EBCDIC is chosen or if the 
data is filtered (see the section on the DOS filter function 
starting on page 144). When there is any question about the 
form of the disk file this option is the safest way to transfer 
data to assure that no data is lost. 

After the transfer is complete the number of tape blocks and 
number of bytes in the tape file will be displayed. A prompt will 
appear at the bottom of the screen asking if you want to 
append another file to this one; see Appending Files on Tape 
below for an explanation of this choice. To transfer another file 
simply hit (enter) at this point Press fisc) to return to the 
labeled tape submenu. 

Copy from Tape to Disk. 


1 Flagstaff Engineering Tape Utility Program 

A) Copy file from disk to tape 

B) Copy file from tape to disk 

Main 

C) List files on the tape Unlabeled 

Tape 

D) Initialize volume label 

»»Labeled tape «« 

E) Switch OS/DOS label type 

Label Type OS/DOS 
Change Parameters 
Initialize Filter 

Command: b 


-<F10.= Help ESC.= Exit Routine>- 

Maximum block = 16384 

<TapeODisk> 

Tape position (C)urrent/file#/filename) C 
Output DOS file 

Translate data? (N=no, A=EBCDIC to ASCII, E: 

=ASCII to EBCDIC) N 

I Datatype: {F)ixed, (V)ariable, (l)BM variable, (S)tring Filter on (N/Y) N 


Figure 17. Labeled tape Submenu-common tape-to-disk fields. 


This option on the labeled tape submenu allows tape files to be 
transferred to disk. When this option is first chosen from the 
labeled tape submenu, the tape will automatically be positioned 
to read the first file on the tape, as indicated by a message that 
appears at the bottom of the screen. The first field that appears 
on the lower half of the screen asks you where you would like 
the tape to be positioned when the transfer starts. Filling in this 
field and hitting (enter) will cause this positioning to take place; 
to choose the pre-filled option of C(urrent), just hit (enter) . The 
positioning options are described below. 

After the tape has been positioned, the other 4 or 5 fields 
common to all tape-to-disk transfers will appear (the 5th field 
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only appears if you have initialized the filter: see the section on 
the DOS filter function starting on page 144). Fill in these fields, 
then press (enter) to start the transfer operation. 

1. Tape position; specifies the position of the tape before the 
transfer takes place. There are three possible choices: 

■ (C)urrent: this leaves the tape in its current position. 
When you first choose this transfer option from the 
labeled tape submenu the tape will be positioned at the 
start of the first file. After a transfer operation the tape 
will be positioned at the start of the next file on the tape. 

■ File #: this positions the tape at the start of a selected file 
by sequence number on tape. If the requested file is not 
found before the logical end of tape is found an error 
message will be displayed. 

■ Filename: this positions the tape at the start of a selected 
file by tape file name. If the named file is not found on the 
tape (by reading the tape’s HDRI labels) a message will be 
displayed. 

2. Output DOS file; this is the fully-qualified name of the DOS 
disk file which will be written which must include any drive 
letters and pathnames needed to identify the file (e.g., 
B:\text\letterl.doc). If the drive and pathnames are omitted 
the file is written in the current directory on the current 
default drive. 

Translate data? three choices are possible; 

N - no translation 

A - data will be translated from EBCDIC to ASCII 

E - data will be translated from ASCII to EBCDIC 

3. Data type: this specifies how the incoming data from tape 
will be treated in transferring it to disk. There are four 
possible choices: 

■ Fixed-length records; the tape file is assumed to be divided 
into equal-length records of a size given by the user. These 
logical records are simply copied from the tape blocks to 
the disk file as they are read. No line delimiters are read or 
written. 

• Variable-length records: this really means variable-length 
physical blocks on tape. Each block in the tape file is 
treated as a separate logical record and these blocks can 
vary in size. In transferring these blocks to disk file records 
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line-end delimiters (e.g. carriage-return line feed pairs) can 
be added to the end of each record to produce a valid 
ASCII-type file-that is a file that can be successfully 
displayed using the TYPE command or printed on a line 
printer. 

■ IBM Variable-length records: this is a special type of 
variable length record where each logical record has a 
4-byte prefix which contains a binary count of characters 
in the record. This count is contained in the first word (2 
bytes) of the prefix and the second word of the prefix is 
usually binary zero. This option is generally only used when 
transferring files from tapes written on IBM mainframe 
computer systems. 

4. String data: this option is used in the case where the tape file 
is not divided into logical records at all (for example an 
executable program file which consists of binary data). The 
tape data is treated as a continuous string of data. The tape 
file is divided into blocks but the blocks are simply fixed-length 
chunks of the input file with a possible short last block. All 
tape data is transferred to disk contiguously (with no 
breaks). 

5. Filter on (N/Y): this field will only appear if the translation 
filter has been initialized from the main menu. If Y(es) is 
specified data from the tape is translated according to 
statements in the filter file before being written to the disk 
file. The default (pre-filled) value here is N(o). See the section 
on the DOS filter function starting on page 144 for more 
information. 

Regardless of the type of data transfer chosen TAPEUTL will 
search for the given output disk file to see if one already exists. If 
it does the following message will appear: 

DOS file already exists 

do you want to erase old file (Y/N) ? 

If you answer Y at this point the existing file will be replaced and 
all data currently in the file will be lost. If you answer N the 
transfer will not start until you hit (enter) again giving you an 
opportunity to change the output file name. 

If the target volume (fixed disk or diskette) that the file is being 
copied to becomes full during the transfer operation the 
transfer will be suspended and the following message will 
appear at the bottom of the screen: 
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DOS volume full 
- new file name (ESC to abort) 

If you want to continue the transfer, you will need to enter the 
name of the file which will contain the next part of the tape file, 
including any needed drive letter and pathname specifiers. The 
transfer will resume with the next byte character) of the tape 
file on the new disk file. To end the transfer, hit (e§c) : the data 
on the full disk volume will be retained, and you will return to 
the unlabeled tape submenu. 

Fixed-Length Data Transfer _ 

-<F10.= Help ESC.= Exit Routine>- 

Maximum block = 16384 <TapeODisk> 

Tape position (C)urrent/file#/filename) jazzercise 
Output DOS file \temp\jazz 

Translate data? (N=no A^EBCDIC to ASCII, E=ASCII to EBCDIC) N 
Data type: (F)ixed, (V)ariable, (l)BM variable, (S)tring F Filter on (N/Y)N 

Record length 50 

Strip trailing pad characters (Y/N) N Pad character 20 

Insert line end (Y/N) N 

Line end characters (in hex) ODOA 

Records to skip 0 

Records to transfer ALL 

Copy complete -1310 records transferred 
press any key to continue: 

FIGURE 18 . Labeled tape-to-disk fixed-length transier Helds. 

Seven additional fields will appear for a fixed-length tape-to-disk 
transfer operation; 

1. Record length: this specifies the length of one logical tape 
record. When the tape file is located, the record length given 
in the HDR2 label is put in this field. To override this length, 
type in the new length here. 

2. Strip trailing pad characters? If Y is chosen here then 
TAPEUTL will remove all trailing pad characters in the output 
record (up to the first non-pad character from the end). 
Usually if this option is chosen the pad character will be a 
space and this option is chosen to eliminate wasted file 
space. If N is chosen no characters are removed from the 
output record. In either case only the output (disk) file is 
affected, not the input (tape) data. 
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3. Pad character; used in conjunction with the preceding option 
this specifies the pad character to be (optionally) stripped 
from the output record. This entry is specified as a 2-digit 
hexadecimal value corresponding to a single character and is 
pre-filled with the most common pad character, the ASCII 
space (hex 20). 

4. Insert line end? this field and the next set options that allow 
a tape file of fixed-length records to be written to disk as a 
file of variable-length records with line-end delimiters. If Y is 
chosen here then each logical record from tape will be have 
line-end delimiters appended in the output record. By 
appending delimiters the file will be essentially a normal ASCII 
text-type file (assuming that the data is ASCII text). 

5. Line end characters (In hex): used in conjunction with the 
preceding option this specifies the line-end characters to be 
appended to each output record if insert line end is 
chosen. These characters (up to 10) are specified as 2-digit 
hexadecimal values. The field is pre-tilled with the most 
common line delimiters the ASCII carriage-return and 
line-feed characters (hex OD-OA decimal 13-10) 

6. Records to skip: this field pre-filled with zero specifies an 
optional number of records from the input file to be skipped 
before the data transfer to tape starts. 

7. Records to transfer: this field pre-filled with ALL specifies an 
optional limit on the number of records to be transferred to 
tape. If only a certain number of records are to be copied 
enter the number in this field. 

After the transfer is completed a message will appear stating 
the number of records transferred. After clearing this message 
you can start another tape-to-disk transfer by filling in the 
appropriate fields and hitting (enter) , the tape will be positioned 
at the start of the next file. Hit (esc) to exit to the labeled tape 
submenu. 
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Variable-Length Data Transfer _ 

-<F10.= Help ESC.= Exit Routine>- 

Maximum block-16384 <TapeODisk> 

Tape position (C)urrent/fil6#/filename) 4 
Output DOS file \temp\slaboom 

Translate data? (N=no, A=EBCDIC to ASCII. E=ASCII to EBCDIC) N 
Data type: (F)ixed, (V)ariable, (l)BM variable, (S)tring v Filter on (NA^N 

Record length 256 

Strip trailing pad characters (Y/N) N Pad character 20 

Insert line end (Y/N) N 

Line end characters (in hex) ODOA 

Records to ship 0 

Records to transfer ALL 

Copy complete - 8 records, 266241 bytes 
press any key to continue: 

FIGURE 19. Labeled tape to disk-variable-length transfer fields. 

Seven additional fields will appear for a variable-length 
tape-to-disk transfer operation: 

1. Record length: this field is for notation purposes only. H the 
tape file was formatted with fixed-length records, the record 
length from the file's HDR2 label will be prefilled here; 
otherwise, this field will be blank. This field is ignored by 
TAPEUTL, except that there must be a non-zero value 
entered here. 

2. Strip trailing pad characters? If Y is chosen here, then 
TAPEUTL will remove all trailing pad characters in the output 
record (up to the first non-pad character from the end). 
Usually, H this option is chosen, the pad character will be a 
space, and this option is chose to eliminate wasted file space. 
If N is chosen, no characters are removed from the output 
record. In either case, only the output (disk) file is affected, 
not the input (tape) data. 

3. Pad character: used in conjunction with the preceding 
option, this specifies the pad character to be (optionally) 
stripped from the output record. This entry is specified as a 
2-digit hexadecimal value corresponding to a single 
character, and is pre-filled with the most common pad 
character, the ASCII space (hex 20). 

4. Insert file end? this field and the next set options that allow 
a tape file of fixed-length records to be written to disk as a 
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file of variable-length records with line-end delimiters. If Y is 
chosen here, then each logical record from tape will be have 
line-end delimiters appended in the output record. By 
appending delimiters, the file will be essentially a normal ASCII 
text-type file (assuming that the data is ASCII text). 

5. Line end characters (In hex): used in conjunction with the 
preceding option, this specifies the line-end characters to be 
appended to each output record if Insert line end is chosen. 
These characters (up to 10) are specified as 2-digit 
hexadecimal values. The field is pre-filled with the most 
common line delimiters, the ASCII r carriage-return and line¬ 
feed characters (hex OD-OA decimal 13-10). 

6. Records to skip: this field, pre-filled with zero, specifies an 
optional number of records from the input file to be skipped 
before the data transfer to tape starts. 

7. Records to transfer: this field, pre-filled with.ALL, specifies an 
limit on the number of records to be transferred. If only a 
some records are to be copied, enter the number in this field. 

After the transfer is completed, a message appears stating the 
number of records transferred. After clearing this message, you 
can start another tape-to-disk transfer by filling in the fields and 
hitting (ENTER) , the tape will be positioned at the start of the 
next file. Hit (esc) to exit to the labeled tape submenu. 

IBM Variable-Length Record Transfer _ 

-<F10.»Help ESC.= Exit Routine>- 

Maximum block . 50000 <Tape0Disk> 

Tape position (C)urrent/file#/filename) C 
Output DOS file \temp\ibmvar 

Translate data? (N=no A=EBCDIC to ASCII E=ASCII to EBCDIC) N Data type: 
(F)ixed (V)ariable (l)BM variable (S)tring i Filter on (NA')N 

Record length 50 

Strip trailing pad characters (YIN) N Pad character 20 

Insert line end (Y/N) N 

Line end characters (in hex) ODOA 

Records to skip 0 

Records to transfer ALL 

Copy complete - 3 records 65757 bytes - 
press any key to continue; 

Figure 20. Labeled tape to disk-1 BM variable-length transfer fields. 
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IBM variable-length record files consist of blocks prefixed with a 
4-byte block length header containing the number of bytes in 
the block and each record is prefixed with a 4-byte record length 
header containing the number of bytes in the record. The layout 
of these blocks and headers is shown in Chapter 1. 

The additional fields that appear on the bottom half of the 
screen for this type of transfer are the same as for simple 
variable-length record transfers. See the preceding section for a 
detailed description of these fields and of the transfer 
operation. 

String Data Transfer _ 

-<F10.= Help ESC.= Exit Routine>- 

Maximum block 50000 <TapeODisk> 

Tape position (C)urrent/file#/filename) C 
Output DOS file FROWN 

Translate data? (N=no. A=EBCDIC to ASCII, E=ASCII to EBCDIC) N 
Data type; (F)ixed, (V)ariable, {l)BM variable, (S)tring s Filter on (N/Y)N 

Characters to skip O 
Characters to transfer ALL 

Copy complete -13250 bytes transferred 
press any key to continue; 

Figure 21. Labeled tape to disk-string data transfer fields. 

The labeled tape-to-disk string data transfer operation works 
the same way as a string transfer going from disk to tapeidata 
is simply transferred byte-for-byte from tape and written out to 
the output disk file. Differing block sizes have no effect on the 
data transfer, and data is neither read nor written as logical 
records, but as one continuous string of data. 

When string data is written to a labeled tape, the record type in 
the HDR2 label is set to U for Undefined, and no record length 
(a length of zero) is recorded in the label. Two additional fields 
appear on the bottom half of the screen: 

1. Characters to skip: this field, pre-filled with zero, specifies an 
optional number of characters to be skipped before the data 
transfer to tape starts . 

2. Characters to transfer: this field, pre-filled with ALL, specifies 
an optional limit on how many characters to transfer to 
tape. If such a limit is needed, enter the number of 
characters in this field. 
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List Files on the Tape 

This option gives a directory listing of the tape. By reading each 
file's header labels (HDRI and HDR2), TAPEUTL lists each file in 
sequence and displays the follo\A/ing information: 

Sequence number; the number of the file, starting at 1. 

Name; the name of the file recorded in the HDRI label, up to 17 
characters long. 

Type: F for fixed-length records V for IBM variable-length 
records U for undefined type. 

Block Size: the physical size of the tape blocks (maximum size—file 
may contain short blocks at the end or in the middle). 

Record size; the logical record length recorded in the file's HDR2 
label (always zero for type 'U" files). 

Number of blocks: number of physical tape blocks in the file. 

If the screen fills up with entries and there are more files to 
display, the display will stop and the following message will 
appear: 

More - press any key Lo continue: 

Hit any key to display the next screenful of entries. When the 
last file on the tape has been found, the message: 

Directory list completed 


will appear at the bottom of the screen. The display will remain 
on screen until you hit any alpha/numeric key to return to the 
labeled tape submenu. 




—<F10.= 

Help ESC.= 

Exit Routine>- 

seq. 

name 

type 

block 

record 

number 


size 

size 



blocks 

1 

GORILLA 

u 

20000 

0 

1 

2 

SETDN 

u 

200 

0 

1 

3 

ZRAY1 

u 

20000 

0 

4 

4 

TURGIL 

F 

6000 

60 

11 

5 

SCUMBY99 

F 

12800 

128 

2 


Directory list completed 

- press any 

key to continue: 


Figure 22. Directory Listing for Labeled Tape 
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Initialize Volume Label 

This submenu option prepares a tape for writing labeled files to 
in This is analogous to formatting a diskette by using the DOS 
FORMAT command). A standard ANSI or IBM label is written at 
the beginning of the tape, and the tape is positioned to write 
the first file. You can also choose to completely erase the tape 
after the volume label to eradicate any existing data; however, 
this operation takes several minutes. 

Because this operation writes a new volume label on the tape, 
any data on the tape should be considered destroyed even if 
you choose not to erase to the end of the tape. This is because 
volume labels may not be written in precisely the same place by 
different systems, even by different runs on the same system. If 
the first file's HDRI label is overwritten by the VOLl label, the 
data can be considered "trashed." If a tape is accidently 
initialized, you may still be able to recover files from it. Use the 
Reposition Tape and Display Records option from the 
unlabeled tape submenu to examine the existing data on the 
tape. 

When initializing a labeled tape, four fields appear on the 
bottom hall of the screen: 

1 Type of label: (this can be one of two types): 

A — writes an ANSI label (in ASCII). 

B — writes an IBM label (standard OS/VS) encoded in 
EBCDIC. 

2 Volume ID: this is a I to 6-character name which will be 
written as the tape volume name. This is the name by which 
the tape would be identified to a minicomputer or 
mainframe operating system. When entering alphabetic 
characters, TAPEUTL changes all lowercase letters to 
uppercase. TAPEUTL does no checking on names, but the 
host system may impose rules for valid names. 

3 System Name: A system name may be entered when 
initializing tapes. This field may be up to ten characters in 
length on IBM volumes and up to fourteen characters long 
on ANSI volumes. This system name is placed in volume VOLl 
record. If no name is entered here, the ID field in the VOLl 
label will be filled with spaces. 

4 Erase to end of tape? This field is pre-filled with N. If Y is 
entered, the tape will be physically erased to the end marker 
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to eradicate any existing data. This operation can take 
several minutes to complete. If this option is chosen and you 
decide to stop while the tape is being erased, hold down 
both fsHiFf) keys simultaneously to stop the erase operation. 
This may cause an error message to be displayed, but hitting 
any key (or (kc)) should clear this message and return you lo 
the labeled tape submenu. 

After these fields are filled in and you press (enter) to start the 
initialization, the message: 

Tape volume label wribben 
should appear at the bottom of the screen. - If the erase to end 
option was used, the tape will run for several minutes, after 
which you will be back at the labeled tape submenu. 

Positioning the Tape and Displaying the Records 
The tape positioning and display submenu looks like this: 


-<F10.= Help ESC.= Exit Routine>- 

A) Forward space by files 

G) Rewind and unload 

B) Back space by files 

H) Write filemark 

C) Forward space by blocks 

1) Display tape record on screen 

D) Back space by blocks 

E) Space to logical end of tape 

F) Rewind 

J) Erase to end of tape 

Command: 



Figure 23. Tape positioning and Display Submenu. 


All the operations on this submenu will work with either 
unlabeled or labeled tapes. When using these functions however 
TAPEUTL doesn't know whether the tape is labeled or not. 
Therefore tape labels are treated the same as separate data 
files when the space forward or backward and display block 
functions are used.You can display a tape's VOL HDR and EOF 
labels just as you can look at any other data on tape. 

NOTE: Any repositioning done here on labeled tape is lost when 
you return to the labeled tape menu! When processing a labeled 
tape the rewind function on this submenu should be used only 
to reposition the tape for the purpose of displaying tape data 
(using the display option on the submenu) or when doing 
transfers to or from unlabeled tape. Do not use this rewind 
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function in conjunction with labeled tape transfer operations 
(tape-to-disk or vice versa); when the labeled tape submenu is 
re-entered after leaving this submenu the tape will 
automatically be repositioned anyway. See the section on 
processing labeled tape for further explanation. 

How the Repositioning Operations Work 

On this submenu notice that there are two types of spacing 
(repositioning) operations: by blocks or by files (filemarks). Each 
can work either forward or backward. All spacing operation 
quantities (blocks or files) are counted from the current tape 
position. The following explains how positioning works. 
Remember that a tape consists of data blocks separated by 
interrecord gaps, and that files are separated by file marks, or 
filemarks. Remember that labeled tapes have special records 
(labels) which are used to record tape and file information. Refer 
to Chapter 1 for an explanation of tape data layouts. 

Spacing Forward/Backward by Files 

When spacing by files, TAPEUTL scans the tape and counts 
filemarks encountered until the specified number of filemarks has 
passed (the default, if no number is entered with this command, 
is one filemark). The tape will then be left positioned just alter the 
last filemark found. 

If the reposition by filemarks operation is backwards, the first 
filemark counted is the one at the start of the file the tape is 
currently positioned at regardless of what the current position 
is within that file. If the current position is at the beginning of 
the file, then a backspace-by-one operation will position the tape 
at the beginning of the previous file, unless the current file is the 
first one on the tape. 

Some examples of spacing by files: (note that the tape is always 
positioned at an IRG between blocks or files) 

Spacing example I. 

BEFORE: 


file 1 

file 1 

■ 

T 

file 2 

file 2 

T 

files 

block 1 

block 2 

■ 

M 

block 1 

block 2 

M 

block 1 


old current position t 
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AFTER: (command given was 'tDackspace 2 files'): 


file 1 

file 1 

■ 

T 

file 2 

file 2 

T 


block 1 

block 2 

■ 

M 

block 1 

block 2 

M 



t new current position 


Spacing example 2. 
BEFORE: 


file 1 

file 1 

T 

file 2 

file 2 

T 

file 3 

T 

file 4 

T 

block 1 

block 1 

M 

block 1 

block 2 

M 

block 1 

M 

block 1 

M 


T old current position 


AFTER: (command given was 'forward space 3 files" 


file 1 

file 1 

T 

file 2 

file 2 

T 

nan 

T 

file 4 

T 

block 1 

block 1 

M 

block 1 

block 2 

M 


M 

block 1 

M 


new current position 


Spacing Forward/Backward by Blocks 

When spacing in either direction by blocks, TAPEUTL scans the 
tape from the current position and counts the number of blocks 
that have passed. When this number matches the number of 
blocks given in the command, the spacing operation is stopped 
and the tape is positioned at the start of a tape block. (If the 
tape is labeled, this could be either a data block or a tape label.) 
If a filemark is found during the space-by-blocks operation, the 
operation is halted and the message File Mark Found will 
appear at the bottom of the screen. The tape will then be 
positioned at the start of the file after the filemark that was 
found. If the space operation was in the backwards direction, 
this will be the same file. If the space direction was forward, this 
will be the start of the next file. Unless a filemark is found, the 
space-by-blocks operation always stays within the same file. To 
space within another tape file, you must first get to that file 
using the space-by-files option (see previous section). 

Remember that a tape consists of data blocks separated by 
interrecord gaps, and that files are separated by file marks, or 
filemarks. Keep in mind also that labeled tapes have special 
records (labels) which are used to record tape and file 
information. Refer to section one for a basic explanation of tape 
data layouts. 
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Some examples of spacing by blocks: 

Spacing example 3. (Note that TAPEUTL jumps over filemarks in 
the forward direction.) 

BEFORE: 



file 1 
block 1 

file 1 
block 2 

file 1 
block 3 

file 1 
block 4 

T 

M 

file 2 
block 1 

file 2 
block 2 

T 

M 


> 

AFl 

' new current position 

"ER (command given was 'forward space 6 blocks'): 


file 1 
block 1 

file 1 
block 2 

file 1 
block 3 

file 1 
block 4 

T 

M 

file 2 
block 1 

file 2 
block 2 

T 

M 



new current position T 


Spacing example 4. 
BEFORE: 



file I 
block 1 

file 1 
block 2 

file 1 
block 3 

file 1 
block 4 

T 

M 

file 2 
block 1 

file 2 
block 2 

T 

M 


old current p 

AFTER (command given was 'backspace 4 blocks' 

losition " 

V 


file 1 
block I 

file I 
block 2 

file 1 
block 3 

file 1 
block 4 

T 

M 

file 2 
block I 

file 2 
block 2 

T 

M 


1 

" new current position 


Note that the tape is positioned at the start of the file if a 
filemark is found before the given number of blocks are skipped. 


Space to Logical End of Tape 

This function reads the tape until the logical end-of-tape is 
found. This is written on the tape as two consecutive tape (file) 
marks following the last file on the tape. Note that this is not 
the same as the physical end-of-tape. The logical end of tape 
may be very close to the start of the tape if there is not much 
data on the tape. 

If there is no logical end-of-tape, the drive will continue to run 
until the tape runs off the supply reel. N this happens, wind the 
tape back on the supply reel and wind the tape onto it by hand 


137 



































Chapter 4—^9-Track Tape Applications 


at least 30-40 turns, then use the drive's Load control to 
re-load the tape. 

Rewind Tape 

This function simply issues the rewind command to the tape 
controller. While the tape is rewinding, a message will be 
displayed at the bottom of the screen, and TAPEUTL will wait 
until the tape is actually rewound before returning control to 
you.if you want to do something else before a long rewind 
operation is done, hitting ( shift) + (shift) will cause the message: 
Rewind stopped 

to appear, and you can choose another function. However, 
this doesn't stop the rewind operation itself, and you must wait 
until the tape is rewound before starting any tape operations. 
You can use such functions as changing the tape parameters, 
which don't directly send commands to the tape drive. 

Rewind and Unload Tape 

This function is identical to the rewind function (above), except 
that the tape is physically unloaded from the drive following the 
rewind. After this command executes, you must reload a tape in 
the drive to do further tape processing . 

Write Tapemark 

This function will write a filemark at the current tape position, 
then space the tape after the filemark. THIS FUNCTION 
SHOULD BE USED WITH CAUTION!! It is provided only for 
special circumstances, when you are certain about the tape's 
current position and need one or more filemarks written there. 

It you write two filemarks in a row, you create a logical 
end-of-filemarker. This can be used when re-writing a tape that 
already has data on it, so that you can be sure that no data 
will be read past the new logical end-of-tape. 

NOTE: All disk-to-tape transfer functions create double filemarks 
at the end of the file, which leaves the tape wilh a valid logical 
end-of-filemarker. 

Displaying Tape Records 

This function can be used with both labeled and unlabeled tapes 
to view the contents of any tape records, including tape labels. 
Tape data is displayed in both hexadecimal and character (ASCII 
or EBCDIC) formats, in lines of 16 bytes on the screen. When 
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you choose this option, data is displayed starting at the current 
tape position. It the tape is positioned at a filemark (end of tape 
file), the first record after the filemark will be displayed. 
Remember that a tape record is actually a tape block. 

The tape display function has a different screen display than the 
rest of TAPEUTL. The top part of the screen shows 20 lines (320 
bytes) of data in hex/character formats, with the displacement 
(distance from the start of the block) shown in decimal at the 
left. The current character representation (ASCII or EBCDIC) is 
shown at the top right. The bottom line shows the block 
number and block length, and contains a command entry field. 
While in the display function, you can space forward by tape 
blocks, displaying data from any part of each block, until a 
filemark is read. When the end of a file is hit, TAPEUTL displays 
the following message: 

Tape EOF (filemark) found - 

press any key to continue: 

The current screen will remain until you hit a key, after which 
you will be returned to the tape reposition/display submenu. It 
you choose the display option again without repositioning the 
tape, the first block of the next file (if any) will be displayed. 

There are several special keys you can use to select tape blocks to 
display and to select the position within the block. They are: 

(PGUP) —displays the previous screen of data from this block. 

(PGDN) —displays the next screen of data from this block. 

(home) —displays the previous block from the tape. 

(en^ — displays the next block from the tape. 

©—scrolls the screen up one line (displays next 16 data bytes). 
©—scrolls the screen down one line (displays previous 16 bytes). 
dD—toggles the character display between ASCII and EBCDIC. 
(esc) —exits the display routine. 

In addition,there are two positioning commands that can be 
entered on the display command line: 
nnn —display data starting at decimal offset nnn into the 
current tape block 

Bnnn —display tape block number nnn. 

(type these commands, then hit ( enter) ) 

For the second command, the operation is the same as the 
space by blocks options from the reposition/display submenu. It 
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a filemark is read before the specified tape block is read, the 
operation will be ended. Also note that the display routine may 
not keep track of the correct block location in the file it you 
forward space to a filemark, then backspace by blocks within 
the file. 

CHANGING THE DISPLAY BETWEEN ASCII AND EBCDIC 

The dD key toggles the display of characters in the file between 
ASCII and EBCDIC representations. This affects only the 
right-hand part of the display (the hex display stays the same). 

It you are displaying data that should be readable text and you 
can't see any recognizable alphabetic characters, you may be 
using the wrong character set. ASCII characters displayed as 
EBCDIC usually appear as "garbage," and vice versa. Binary 
data (binary data files, executable programs, etc.) will always 
appear as meaningless bytes, although you should be able to 
read embedded program prompts, messages, and other text. 

TAPE RECORD DISPIT^Y SCREENS 
Display screen 1. 

This screen shows the HDRI label from an ANSI-labeled tape file. 
Notice that the data is encoded in ASCII, and that the label is 80 
bytes 

DISP HEX DATA ASCII 


0 48 44 52 31 47 49 52 4146 46 45 20 20 20 20 20 

16 20 20 20 20 20 59 4F 46 4F4F4C30 30 30 31 30 

32 30 30 31 30 30 30 31 30 30 20 38 36 32 39 30 20 

48 30 30 30 30 30 20 30 30 30 30 30 30 20 20 20 20 

64 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 


|HDR1 GIRAFFE 
I YOFOOL00010 
1001000100 86290 
100000 000000 


COMMAND: BLOCK 2 LENGTH 80 Press ESC to exit 

Display screen 2. 

This screen shows a data block trom an ASCII text file. Notice 
that each line of text is ended by the bytes OD OA (carriage 
return-line feed). 


140 



Chapter 4—^9-Track Tape Applications 


DISP HEX DATA ASCII 

0 OB2E 743A 70 63 77 32 63 6F 72 6F2E70 72 6D |.t:pcw2coro.prm 

16 0D0A 09 2E 773A 34 370D0A0C00 0A0D0A0D |.w:47. 

32 OAODOAODOA20 20 20 20 20 20 20 2015 46 4C |. FLAGSTAFF 

48 41 47 53 54 41 46 46 20 45 4E 47 49 4E 45 45 52 | ENGINEERING, INC 

64 49 4E 47 0D0A0D0A0D0A20 20 20 20 20 20 20 |. 

80 20 20 20 20 20 2015 54 41 50 45 20 55 54 49 4C | .TAPE UTIL 

96 49 5459 0D0A0D0A0D0A20 20 20 20 20 20 20 |ITY. 

112 20 20 20 20 20 15 55 53 45 52 27 53 20 4D 41 4E | .USER’S MAN 

128 55414C0D0A20 0D0A0D0A0D0A0D0A0D0A |UAL . 

144 OD OA OD OA 00 OA OD OA OD OA OD OA 00 OA OD OA |. 

160 ODOAODOAODOAODOAOD0AODOA2O2O2O2O |. 

176 20 20 20 20 20 20 20 20 20 20 20 20 201C 43 6F | .Co 

192 70 79 72 69 67 68 74 20 31 39 38 36 OD OA 2C 20 Ipyright 1987 . 

208 20 20 20 20 20 20 20 20 20 20 20 1C 46 4C 41 47 j .FLAG 

224 53 54 41 46 46 20 45 4E 47 49 4E 45 45 52 49 4E |STAFF ENGINEERIN 

240 47 00 OA 20 20 20 20 20 20 20 20 20 20 20 20 20 |G. 

256 20 20 20 20 20 20 20 1C 42 6F 78 20 3139 37 30 | 1120 KAIBAB LANE 

272 ODOA 20 20 20 20 20 20 20 20 20 20 20 20 20 20 \ . 

288 1C 46 6C 61 67 73 74 61 66 66 2C 20 41 5A 20 38 [ .FLAGSTAFF, AZ 8 

304 36 30 30 32 OD OA 20 20 20 20 20 20 20 20 20 20 |6001. 


COMMAND: 


BLOCK 1 LENGTH 7081 Press ESC to exit 


The Change tape parameters submenu provides a way to 
change a number of system values. Some are hardware-related 
and change the way the tape drive and controller operate, 
while others are software parameters. 

Parameters are changed by entering the right letter in the 
command field and pressing (enter) . If you use fisc) to exit this 
submenu before changing a parameters, no changes are made. 


-<F10.= Help ESC.= Exit Routine> 

A) Set low tape speed (default) 

B) Set high tape speed 

C) Set short interrecord gap for write (default) 

D) Set long interrecord gap for write 

E) Set error retry count (default = 16) 

F) Set tape address (O = default) 

G) Set 1600 bits/inch density (default) 

H) Set 3200 bits/inch density 

I) Set maximum buffer size for read 


Command: 


Figure 24. Change Tape Parameter Submenu. 
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Each of the parameters on this menu are explained in the 
following sections. 

Set low tape speed (default) 

This option selects the low tape speed for drives that have 
software selectable speeds (not all drives do). Speed selection is 
highly drive-dependant, and this option may not be usable on 
your drive. On drives that have 2 software-selectable speeds, 
low speed is usually 25 ips (inches per second). Other smart 
drives have several speeds, but their speed is a function of the 
data transfer rate and is not selectable by this option. Refer to 
your drive’s operating manual to determine it you can select 
tape speed. 

Low speed is the default set by TAPEUTL at startup time. 

Set high tape speed 

For drives with software-selectable speeds, this option sets the 
high speed. This option may have no effect, since speed selection 
is highly drive-dependent (see above). If high speed is available, it 
is usually 100 ips (inches per second). 

Caution! If your computer is an IBM AT or compatible (not a PC 
or XT), you may not be able to use high speed tape transfer. 
Strangely enough, the AT’s highest possible data transfer rate is 
slower than that of the PC or XT (our testing has found the 
effective upper limit to be near 100 kB/sec). The data transfer 
rate is a function of both tape speed and tape density; 
transfer rate = density X speed 

For example, at 100 ips and at a density of 1600 bpi, the data 
transfer rate would be 160 kB/sec, which is too fast for an AT. 
You would need to use low tape speed (25 ips), which would 
bring the transfer rate down to 40 kB/sec. 

Set Short Interrecord gap for write 

This option sets the default IRQ, approximately 0.6 inches. The 
IRQ setting affects tape write operations only. 

Set long Interrecord gap for write 

You can set your drive to write with a long IRQ between blocks. 
The long IRQ is about 1.2 inches, twice as long as the standard 
short IRQ. The only reason to use a long IRG would be to keep 
the tape drive in streaming mode during write operations, 
where the drive is operating continuously rather than starting 
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and stopping between writes. With the current implementation 
of TAPEUTL, no increase in speed is gained with this option. 

Set error retry count 

This option sets the number of retries that TAPEUTL will attempt 
before reporting a hard tape error. The default number of 
retries is 16. You should increase this number if you are trying to 
read or write a marginal quality tape. Keep in mind that doing 
so will increase the time required for all transfer operations, as 
multiple reads and writes may be required before a good 
operation occurs. 

To set a new number of retries, follow the option letter by the 
new count. For example; 

e 24 

will set the error retry count to 24. Typing the option letter only 
will display the current value of the retry count. 

Set tape address 

The tape address is the logical unit number of a particular tape 
drive, O through 7. This address is selected at the drive by either 
switches or jumpers, and the address used by TAPEUTL must 
correspond to this address. For most users with a drive, this 
address will be 0; the default set by TAPEUTL at startup. 

By changing the tape address, you can use more than one tape 
drive in a single session with TAPEUTL. Once the address is set, it 
remains set until reset or until you exit TAPEUTL. 

Set 1600 bits/inch density 

This option sends a command to the tape drive to set the tape 
density for both reads and writes to 1600 bpi, the default set 
by TAPEUTL at startup. Note that some tape drives will not 
respond to a software density-select command. 

Set 3200 bits/inch density 

n the drive in use will operate at 3200 bpi, this option will select 
this higher density for both reads and writes. Otherwise, this 
option will have no effect. 

Set maximum buffer size for read 

This option sets the size of the buffer used by TAPEUTL for tape 
reads. The default size at startup is set to 16 kB (16,384 bytes). 
The maximum size selectable is 64 kB (65,536 bytes). 
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To set the buffer size to a new value, follow the option letter by 
the new buffer size—^for example; 

132000 

will set the buffer size to 32,000 bytes. Typing the option letter 
only will display the current maximum buffer size. 

If you receive a Tape block exceeds maximum error 
message during a tape operation, increase the buffer size with 
this option, then retry the operation. 

The buffer size should not be set much larger than necessary, as 
this will slow down the average data transfer rate. 

The DOS Filter Function 

TAPEUTL has a data filter that can convert characters in the 
data stream, during both tape-to-disk and disk-to-tape 
transfers. The filter consists of translation statements in a file. 
Each statement specifies that a certain character or string of 
characters is to be changed to another character or string of 
characters each time it appears in the data stream. This file is an 
ASCII text file which can be created or modified by any text 
editor or word processor which handles ASCII files (DisplayWrite 
3, Wordstar in non-document mode, EDLIN, etc.). 

Initializing the DOS Filter 

The filter function is set up from the main menu by choosing 
option E from the main menu. The following single prompt will 
appear on the bottom half of the screen; 

Code translation file: 

Simply enter the name of the file containing the filter translation 
statements, including any needed drive letter or pathname 
qualifiers. Press (enter) to submit the file to TAPEUTL. After the 
file is found, it will be read into TAPEUTL’s workspace, n the file is 
read with no errors, the following message will appear; 

Code translation filter initialized: 

If the given file can't be found, or if the translation file contains 
invalid statements, an error message will appear, and you can 
re-enter the filename or exit this option by use of fisc) . 

How and When the Filter Functions 

Whether the data filtering function operates before or after the 
other processing functions (handling line-end characters and 
ASCII/EBCDIC translation) depends on whether the transfer is 


144 



Chapter A —9-Track Tape Applications 


from disk to tape or vice versa. The following illustrations show 
the flow of processing for both types of transfer. 



Figure 26. Tape -to- Disk Processing Flow 


* —these operations do not apply to string-type data transfers 

The filter function is shown in a dotted box indicating this pan of 
the processing flow is optional. 

Understanding when the filter function is applied to the data 
flow is extremely important to insure the proper results. You 
can easily get into trouble with filtering, especially if any changes 
are made to line-end delimiter characters or if filtering changes 
the length of data records. 

It is safest to use filtering on string-type data, since no scanning 
for (or insertion of) line-end delimiters occurs. If you use variable 
length records, care must be taken in altering data with the 
filter. There are three situations in particular to be aware of; 

1 If line-end delimiters are altered during a disk-to-tape 
transfer, then the new line-end characters are the ones 
which must be specified on the transfer screen, since the 
filter alters the data before the line-end processing routines. 

2 If the filtering process has the potential for changing the 
length of data records, the maximum record length should 
be given as the new longest record length, after any filtering 
has been done. Otherwise, records may be incorrectly split. 

3 If any characters which would be treated as pad characters 
are altered by filtering (e.g., trailing spaces), the new 
character must be given as the pad character to strip during 
the transfer operation. 

Filter Translation Statements 

All statements must begin in the first position on the line, and all 
string specifiers must be separated by at least one space. All 
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statements can include a comment field, indicated by square 
brackets below {the brackets themselves are not required), 
separated from the end of the statement by at least one space. 
The maximum number of translation statements in a file is 
2,000, not counting single character (1-to-l ) statements. The 
maximum number of bytes in translation strings is 12,288. The 
command file text can be a total of 24,576 bytes long. 

Each translation statement can be one of three possible types: 

■ simple string replacement 

■ toggle string replacement 

■ wildcard string replacement 

The first two types (character strings) are indicated in one of 
three ways: 

1. ASCII character string: 

A'.' 

The periods indicate any number (up to 64) of characters. The 
apostrophes are delimiters that mark the beginning and end of 
the string. Any character can be used for the delimiters, so long 
as it doesn’t occur within the string itself. The delimiter character 
must be the first character after the A . To include an 
apostrophe in the string, use another character as a delimiter: 
A/doesn't/ 

2. EBCDIC character string: 

E'.' 

EBCDIC strings are specified the same as ASCII strings (above), 
except that the EBCDIC equivalents of the characters will be 
searched for or replaced in the data stream. 

3. Hexadecimal byte string: 

X'XX XX ... xx' 

Each “xx" indicates a byte as a pair of hexadecimal digits (0-9 
and A-F). The string can include up to 64 bytes of data. The 
delimiter must be the first character after the X and there must 
be one space between each pair of hex digits. This form of string 
specifier can be used where the desired bytes for searching or 
replacement cannot be written as characters in the statement 
itself; for example, carriage returns, tabs, line feeds, etc. 
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FILTER TRANSLATION STATEMENT TYPES 

1. Simple String Translation Statements 
This is a line in the file in the form: 

old string new string [comment] 
where old string and new string are each one of the string 
specifier forms given above. The simple replacement statement 
simply does a oneor-one replacement; each occurrence of old 
string in the data stream is replaced by new string. This 
statement can also be used to delete old string by simply 
omitting new string in the statement. 

2. Toggle String Replacement Statements 
The toggle statement has the form: 

T old string new string 1 new string 2 [comment] 

The T must be the first character on the line. Each of the 3 
strings in the toggle command can be any of the 3 string 
specifier types given above. The toggle replacement statement 
does alternating replacement of character strings. When old 
string is first found in the data stream, it is replaced by new 
string 1. The next time it is found, it is replaced by new 
string 2. the next by new string 1, and SO on. This function 
is useful tor translating printer control codes (boldface, 
underline, etc.) which must be turned on at the start of some 
text, then turned off at the end of the text. 

3. Wildcard String Replacement Statements 
The wildcard statement has the form: 

W old string new string [comment] 

For the wildcard statement only, special string specifiers are 
used. Each statement starts with the character W. These are 
the same as the other specifiers described above, except that 
the question mark character has a special meaning within these 
strings. Whenever a ? is given in a wildcard string specifier, any 
character in the data stream will match at this position. The new 
string specifier can also contain ? characters. If present, they 
will be replaced by characters from the data stream at the 
corresponding position in the string. Using wildcard translation, 
you can convert strings where only part of the string must 
match exactly. 

For example, the translation statement: 

WA Dave ?????? A Chris?????? 
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will cause the following translations: 

old string _ new string 

Dave Johnson Chris Johnson 

Dave posters -> Chris posters 
Dave # 12345 -> Chris #12345 

You can use ASCII, EBCDIC or hexadecimal string specifiers with 
the wildcard statement. To specify a character in a hex string, 
use the hex equivalent of the ASCII question mark, 3F. The only 
limitation is that you cannot specifically search for or replace a 
question mark with this type of statement. The question mark 
character itself, however, will match if it is found in the data 
stream where there is a question mark in the string specifier. 

Special Note on ASCII vs. EBCDIC Character Strings 

When the terms "ASCII character' and "EBCDIC character" are 
used, these refer to characters in the data stream to or from 
tape—NOT characters in the translation statement file. The text 
in the translation file itself must be all ASCII, which is the native 
character set of the IBM PC. 

If a string specifier statement refers to an EBCDIC "e', this 
means that it will match or replace with the character that 
corresponds to the EBCDIC "e" character. The "e" in the 
translation file is in ASCII, always. 

Translation Statement Exampies 

A/"/ A/'/ 

This statement replaces all ASCII quotation marks in the data 
stream with ASCII apostrophes. 

X'OD OA'X'OD 25' 

replaces the hexadecimal byte string OD OA (ASCII carriage 
return-line feed) with the byte string OD 25 (EBCDIC CR/LF). 

TX'02'X'1B6531'X'1B6530' 
alternately replaces the hexadecimal byte value 2 with the 
second and third byte strings (these strings are toggle printer 
control codes). 

WA'file.???' A'file???.XYZ' 

searches for the ASCII text string file, followed by any three 
(3) characters. The three characters are then moved to a new 
position in the string. 
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Special Note on the Order of Translations 

The filter function first performs all multiple-character 
translations, then all single-character (one-to-one) translations. 
Therefore, it makes no difference which order any one-to-one 
translation statements appear in the translation file. However, 
the character strings to be replaced will be searched for in the 
order that they appear in the translation file. To ensure that 
the proper translations are made, you should realize that this 
order is important, n the same string of characters are being 
searched for in two translations of differing lengths, the longer 
string must be specified first. Otherwise, the shorter string will 
be found and translated first, and the longer string will never 
be found. 

For example, if the following two statements are in the 
translation file: 

A'ab' E'ab' 

A'abnormal' E'unusual' 

the ASCII string abnormal will never be found because the 
string ab will have already been translated to EBCDIC. 

Reversing the order of these statements would allow the longer 
string to be found and translated. The following example shows 
an application of filtering, illustrating the translation file, and 
the input and output streams: 

Translation file: 

A'bad' A'good' 

A'good' A'bad' 

A'dogs' A'people' 
a'" " a'' " 

TA' flip' A' flip' A' flop' 

WA'Dave ???????' A'Chris ???????' 

Input data: Some dogs are very bad, even on good days. Dave 
Johnson had one once that wouldn't even fetch his paper, so 
he sold it to Dave Oliver (who then gave it to Dave Jones). Like 
most dogs, his tail would go 'flip flip flip flip flip flip'. 

Output data: Some people are very good, even on bad days. 
Chris Johnson had one once that wouldn't even fetch his paper, 
so he sold it to Chris Oliver (who then gave it to Chris Jones). 

Like most people, his tail would go "flip flop flip flop flip flop". 
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Automatic Operations of TAPEUTL 

TAPEUTL has a facility to allow you to create command files 
which can later be used to run the program in automatic mode. 
This feature can be used to relieve the PC user of the task of 
entering commands manually for repetitive tape transfer jobs. 
For instance, if you process a certain kind of tape regularly, you 
can create an automatic command file for the processing 
session, then simply run TAPEUTL under the control of this 
command file whenever those tapes are processed. 

The command file is created by running TAPEUTL in a special 
record mode. In this mode, all commands and keystrokes 
entered from the keyboard are stored and written to the 
command file. When the program is later run under control of 
the command file, all these commands and keystrokes are 
executed in their original sequence. 

The automatic-mode feature includes options which allow 
pauses in automatic execution, during which the user can file in 
fields in screens before continuing in automatic mode. 

The Automatic Mode Status Marker 

When you are in automatic mode, either during recording or 
playback, an additional status marker appears at the top left of 
the screen. There are four different markers: 

Rec —current session is being recorded 
Man —manual mode has been entered during either 
record or playback 

Auto —session is being run in automatic execution mode 
****—error was encountered during automatic 
execution; reverts to manual mode. 

Recording Your TAPEUTL Session 

To create an automatic execution command file, give the name 
of a file which doesn't currently exist on the DOS command line, 
as shown here: 

Citapeutl newfile.cmd 

where newf lie. cmd is the name of the file where the 
automatic execution commands will be written (the reason the 
file cannot already exist is that an existing file will be taken by 
TAPEUTL as containing commands to run in automatic mode). 
When TAPEUTL is invoked this way, every keystroke from that 
point is recorded and saved in the command file. Therefore, you 
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should plan your session carefully so that no extraneous or 
unnecessary command paths are taken. When TAPEUTL plays 
back a session, it just blindly follows your original path. 

Providing for User input in Automatic Mode 

When you are recording a session, you can cause the automatic 
execution to be temporarily suspended, to allow the user to 
enter information in screens (tor example, file names). You do 
this by pressing (H) at the point where you want automatic 
mode to be suspended. When you do this in record mode, the 
automatic status marker will change to Man, to indicate that 
manual mode has been entered. During recording, you can 
continue filling in fields, but these entries will no longer be 
written to the command file. This manual mode will continue up 
to the point where you hit the (enter) key during both record 
and playback. When (enter) is pressed, the program will revert 
back to record mode, or back to automatic execution during 
playback. 

When dD is used to enter manual mode, the cursor position at 
that point is saved. When the command file is executed later, 
this becomes the initial cursor position during playback. You can 
use this fact to position the cursor to any desired field when 
recording your session. 

Ending Automatic Execution Recording 

There are two ways to end the recording of a session: 

■ by normal termination of TAPEUTL (using fisc) to exit back to 
DOS from the main menu). This closes the command file, and will 
cause an exit to DOS at the end when the command file is later 
used to run TAPEUTL 

■ by using the (m) key during record mode. This closes the 
command file, and will cause TAPEUTL to enter manual mode (as 
indicated by the marker Man) during later automatic execution. 
At this point, the user has complete control, just as under 
normal program operation. 

Running TAPEUTL from a Command File 

To cause automatic execution of TAPEUTL, simply enter the 
name of a previously recorded command file on the DOS 
command line; 

CitapeuLl auLofile.cmd 
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This command will cause TAPEUTL to be run under the control of 
the keystrokes stored in the given command file. The status 
marker Auto, will appear at the upper left, and you will see 
screens flash by as the stored commands are executed. The 
program may stop during automatic execution tor one of two 
reasons: 

■ if the marker Man appears at the upper left, that means 
that manual mode was entered when the command file was 
recorded, either temporarily (using (ED), or permanently 
(using (g)). During playback, you now have control and 
must fill in the necessary fields and press (enter) to continue. 
If you still have control after (enter) was pressed, then the 
original session was ended with and you are now 
permanently in manual mode. Otherwise, control will revert 
back to automatic execution. 

■ if the marker * * * * appears, that means that an error was 
encountered during the current session. Either an actual 
error occurred (file not found, tape error, etc.), or your 
session took a path that diverged from the original recorded 
session. In either case, TAPEUTL reverts back to manual 
mode permanently, and you now have control over the 
program from the keyboard. 

ASCII Batch Command File 

TAPEUTL commands may be placed in an ASCII batch file created 
with any text editor or generated by a program. Each 
command entered when running the program must be entered 
in the batch file with the exception of the initial (HD for paging 
past the initial copyright screen (the copyright screen is 
automatically skipped when running from a batch file). 

Special keys such as (tab) , (esc) . (FT) through (Fio) . (pgup) . (pgdn) . 
etc. may be assigned by entering the key code preceded and 
followed by tilde sign (~). As an example, the escape key may be 
entered as ~ESC~. Either upper or lower case letters may be 
used. 

The following special key codes are recognized: 
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ESC 

Escape key 

TAB 

Tab key (right tab) 

STAB 

Shifted tab (left tab) 

FI -FIO 

Function keys 

SF1 -SFIO 

Shifted function keys 

CFl -CFIO 

Control function keys 

AFI -AFIO 

Alternate function keys 

A0-A9 

Alternate numeric keys 

A- 

Alternate hyphen 

A= 

Alternate equal 

Ax 

Alternate any key (x any letter key) 

UPAR 

Up arrow 

DNAR 

Down arrow 

LFAR 

Left arrow 

RTAR 

Right arrow 

HOME 

Home key 

END 

End key 

PgUp 

Page up 

PgDn 

Page down 

INS 

Insert 

DEL 

Delete 

CLAR 

Control left arrow 

CRAR 

Control right arrow 

CPGU 

Control page up 

CPGD 

Control page down 

CHOM 

Control home 

CEND 

Control end 


The old batch routines for TAPEUTL are still implemented. When 
the program is initiated and a batch file name is entered on the 
command line, it is processed as before. If the file does not exist, 
the program goes into automatic mode and tries to execute a 
file which was created before learn mode. If it does not exist, 
the program goes into auto mode and tries to execute a file 
which was created before in the learn mode. To execute an 
ASCII batch file, the file name must be preceded by an equal 
sign, such as: 

C:>TAPEUTL =FILE.ASC 
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Tape Data Extraction 

Tape Data Extraction is designed to extract data from I /2-inch 
magnetic tape files and transfer the data to an IBM PC file. 

Data is extracted and transferred field-by-field from tape files 
with fixed length records. 

Formats supported are /MMSI unlabeled and IBM labeled tape. 

Various types of conversions may be performed on fields from 
the input tape file. Field conversions are specified by the 
operator and then stored in a control file for use by the 
conversion program. TDE provides the following types of data 
manipulation: 

Character fields 

■ /\SCII-to-EBCDIC conversion 

■ EBCDIC-to-ASCII conversion 

■ User specified translation 

Numeric fields 

■ Input fields may be converted from or to any one of eight 

different numeric formats. 

Field Insertion 

• Literal character strings or numeric fields may be inserted into 
the output records. 

Input record select/reject 

■ Input records may be selected or rejected based on 
comparisons made on input record fields. 

How Programs inThis Package Work Together 

This package contains several separate programs plus a batch 
file called TDE.BAT which can be used to nun the data extraction 
programs as a single jobstream. The following figure shows 
schematically how these various programs are related: 
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The batch file TDE.BAT runs both EXTRACTT and RECONT in 
sequence tor one-of-a-kind conversions. If a standard conversion 
needs to be nun repeatedly the control statement file created 
by EXTRACTT can be reused and only RECONT need be nun each 
time. 

System Requirements 

Use of the TAPE DATA EXTRACTION programs require the 
following minimum system configuration: 

I IBM PC/XT/AT with a minimum of 512 kB of RAM. All available 
memory is used as a work butter during the conversion 
process which results in faster conversion times on machines 
equipped with larger amounts of memory. A fixed disk is 
highly recommended. TAPE DATA EXTRACTION may be used 
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on diskette-only machines but normal output file sizes may 
exceed the capacity of standard diskettes. Multi-volume 
diskette output is supported but since read/write times to 
diskette are much longer that to fixed disk a substantial loss 
in speed will occur. 

2 An Overland Data controller card and cable. 

3 9-track tape drive (Pertec/Cipher standard). 

Program Descriptions 

TAPE DATA EXTRACTION consists of the following programs and 
files: 

EXTRACTT. EXE 
RECONT.EXE 
TDE.BAT 
RECFMT.EXE 
INSUTILEXE 
EXTRACTT.EXE 

This is a full screen menu driven editor that allows the user to 
specify the conversions to be specified tor a tape data file. The 
program stores the conversion parameters in a control 
statement file on disk or diskette. 

RECONT.EXE 

This program performs the actual file conversion and transfer. 
The program requires a control statement file specifying the field 
conversions to be performed. 

TDE.BAT 

This batch file will execute the programs EXTRACTT.EXE and 
RECONT.EXE in sequence. This allows the operator to enter the 
conversion parameters for a tape file and then automatically 
perform the conversion on the file without loading another 
program. TDE.BAT is an ASCII text file and may be modified or 
created by any simple text editor. 

RECFMT.EXE 

This program will display the conversion parameters contained 
in a control statement file created by EXTRACTT. 

INSUTILEXE 

This program is used to set screen display colors tor 
EXTRACTT.EXE. 
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EXTRACTT.EXE Program 

EXTRACTT allows you to examine tape file records define fields 
tor data transfer and creates a control statement file 
containing conversion commands. The control statement file will 
be used by the RECONT program at conversion time to guide 
the tape-to disk transfer operation. 

The name of a control statement file to be created or an existing 
control statement file may be indicated when EXTRACTT is run. A 
maximum of 250 statements may be edited with EXTRACTT. The 
control statement file name should be entered after the 
program name to use this option. Entering the following line at 
the DOS system prompt would cause EXTRACTT to use a control 
statement file named CONPARM.DAT: 

C extractt conparm.dat 

In the above example EXTRACTT would search tor a DOS file 
named CONPARM.DAT. If the file is found the control state¬ 
ments in the file will be read into memory for editing or 
modification. If the control file does not exist it will be created by 
the EXTRACTT program. 

It a control file name is not given at program load time the file 
name will be requested on the first screen of the program. 

General Features 

The EXTRACTT program provides the user with a complete set of 
editing screens that allow the user to create a control 
statement file that will support most conversion requirements. 

EDITING SCREENS 

INITIAL—Initial program screen: specify tape file and record type. 
MAIN—Display tape file records and select editing subscreens. 
SELECT—Select or reject records by field comparison. 

MOVE—Move a field from input record to output record. 
NUMERIC—^Translate numeric input field to a numeric output 
field. 

FILL—Fill a field with ASCII EBCDIC or hexadecimal values. 
LITERAL—Insert ASCII EBCDIC or hexadecimal values in output 
records. 

FINAL—Specify output file name and record type and length. 
HELP—Numeric field specifiers. 

The (ESC) key may be pressed on any screen to return to the 
next higher level without performing any of the screen 
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functions. If (fsc) is pressed on the FINAL screen no control file 
will be written. 

On each screen the cursor may be moved from field to field 
using the key or (SHiFD + fi^ to move in reverse. After all 
screen prompts have been filled in with data the data is submit¬ 
ted to the program by pressing the (enter) key. 

Screen Description—INITIAL 

This screen is displayed immediately after program load. The 
screen is used to specify the tape input file to be converted the 
control statement file name that will contain the conversion 
parameters for the tape file specified and tape drive address 
and speed setting. 

Screen Entries 

INPUT FILE NAME 

Must be entered. The tape file is specified as follows; 

# — this will access a tape file by number as recognized by 
counting tape (file) marks from the beginning of the tape, 
name — this will access a labeled tape file by file name. 

RECORD TYPE 

This must be supplied and must be either f (fixed length records) 
or V (variable length records). The only exception for this 
prompt is when accessing labeled tape files with fixed length 
records. The record type and length will be read from the tape 
label and automatically displayed. 

RECORD LENGTH 

Must be entered and must be between 1 and 9999. The only 
exception is for labeled tapes with fixed length records. 

TAPE SPEED HIGH/LOW 

Optional. Default is l (usually 25 ips depending on the tape 
drive). High speed (100 ips) may be indicated by entering an h. 
High speed may not be supported on your drive. 

ADDRESS 

Optional. Default tape drive address is zero (0). May be any 
number between 0 and 7. 
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COMMAND FILE NAME 

Required. May be any desired DOS file name. The file name must 
be fully qualified including any needed drive letters. 

Labeled Tape Notes: 

When accessing labeled tapes with fixed length records in the 
input file only the input file name need be entered: The screen will 
display the record type and length. At this point the values may 
be accepted as is or the values obtained from the tape label 
may be overridden and then entered. 

Existing Control Statement Files: 

When accessing an existing control file this screen will be filled in 
from the control file. Press (enter) to accept all entries as is or 
type over any desired fields then press (enter) . 

Screen Description—MAIN 

This screen is displayed after the INITIAL screen has been 
completed. 

This screen is the main editing screen for creating conversion 
control statements that will be written to the control 
statement file. The screen supports a field edit function that 
allows the operator to define specific fields for conversion. 

Screen Divisions 

The screen is divided into an upper and lower section. The upper 
section of the screen is the record display area. The lower section 
of the screen is the function and edit menu. 

Upper Screen 

The first data record from the tape input file will be displayed on 
the upper half of the screen. The Input file may be scrolled 
through record by record. Both forward and reverse scrolling is 
possible using (pgdn) to scroll forward and (pgOp) to reverse scroll 
through the file. 

Data records may be displayed as ASCII or EBCDIC characters. 
The data display may be toggled between ASCII and EBCDIC by 
pressing (fbI . 

Data fields in the input records must be defined for conversion. 
Several edit functions are provided to accomplish this. 
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A field is defined by a beginning and ending field position in the 
record. The beginning and ending field position must be marked 
to indicate a valid field. 

Field Marking 

To mark fields for conversion press the (H) to enter edit mode. 
The cursor will move to the file record displayed at the top of the 
screen. The cursor may be moved through the data bytes of 
the record by using the arrow keys (note that ( ) 

(spacebar) = Q))- This allows positions in the input record to be 
selected by pressing (FT) to mark the beginning and end of a field 
to be moved translated or used for a select/reject statement. 
The (ID key is used to remove a mark that is under the cursor. 

To remove all marks press (ctrl) +(f2). To return to the bottom 
of the screen after a field has been marked press (H) again. Use 
fisc) to remove marks and return. 

Each marked field requires a control statement for the specific 
conversion to be performed on that field. Note that the 
markers for selecting data from the input record MUST be set 
BEFORE going to the specific routines which create data 
conversion statements. The statement number of the control 
statement being created is displayed in the upper left corner of 
the bottom portion of each of the screens). After a field has 
been marked select a conversion for the field by entering the 
number for the desired type of control statement to be created 
(I - 5). The program will display the statement creation screen 
selected and wait for input. After all screen entries have been 
completed press (enter) to save the control statement. The 
program will re-display the MAIN screen and display the next 
statement number to be created. 

To edit existing control statements enter an E followed imme¬ 
diately by the statement number to display a specific statement 
(example: E5 will display control statement number 5). The 
statement and the appropriate statement creation screen will 
be displayed. The next statement occurring before or after the 
cu rrent statement may be displayed by pressing (It^ or (home) . 
or dlD may be used to return to the MAIN menu. 

Once a statement has been displayed in edit mode it may be 
altered by typing new entries over the existing entries and 
pressing (enter) . The statement may be deleted by pressing 
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(alH+d. The program will then display the next control 
statement. 

Control statements are generally created in the same sequential 
order as the fields being defined for conversion. New 
statements are automatically added to the end of the control 
statement file. Control statements may be inserted rather than 
added if desired. To insert a new control statement between 
existing control statements display the record which follows the 
record to be inserted. Press then enter an option of T 
followed by the type of statement you wish to insert. 

For example to insert a select/reject statement preceding 
statement number 12 enter El2 (display statement 12). Press 
(Is^ and then enter II (insert statement type 1). 

Control Statement File Sequence: 

In general all select/reject control statements should be entered 
first. If the remaining statements are created in the same 
sequential order in which they are to appear in the output 
record the program will keep track of the next available output 
record location. The program will pre-fill the beginning and 
ending field position specifiers for the statement creation 
screens being used. 

After all field conversion specifications have been defined for 
output records enter option “6" to exit the editing functions. The 
program will display the FINAL screen. 

Screen Description—FILL 

This screen is used to create fields in the output record that will 
be titled with a specific character. The fill character may be 
specified as ASCII EBCDIC or hexadecimal. 

Screen Entries 
FILL CHARACTER 

Entry is required. This is the character to fill the output field 
with. If it is being specified in hex then it must be two valid 
hexadecimal digits. 

ASCII/EBCDIC/HEX 

This entry indicates the character type. The entry defaults lo 
ASCII. If specified the character type must be one of the 
following: 
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A ASCII character 
E EBCDIC character 
X Hexadecimal value. 

BEGINNING LOCATION 

Must be specified. This entry specifies the beginning byte position 
in the output record that will be filled. The program will pre-fill 
this entry with the next available output position. 

ENDING LOCATION 

Must be specified. This entry specifies the ending byte position in 
the output record that will be filled. 

Screen Description—INSERT 

This screen is used to create a literal field in the output record . 
The character string may be specified as ASCII EBCDIC or 
hexadecimal. 

Screen Entries 

ASCII/EBCDIC/HEX 

This indicates the character type. The entry defaults to ASCII . If 
specified the character type must be one of the following: 

A ASCII character 
E EBCDIC character 
X Hexadecimal value. 

BEGINNING LOCATION IN OUTPUT - 

This entry must be specified. The program will pre-fill this entry 
with the next available output position. 

DATA 

One or more characters must be entered. If the string type is A 
or E the string must begin and end with a delimiter character 
which does not appear in the actual string. For example the 
entry HELLO/ indicates the string HELLO with slashes used as 
delimiters. 

If a Hexadecimal string type is specified the data must be 
entered as a series of two hex digit bytes separated by single 
spaces. 


162 



Chapter 4—9-Track Tape Applications 

Screen Description—MOVE 

This screen is for moving a field from the input record to the 
output record and optionally translating it. Note below that 
the user may optionally supply the translate table. 

Input Location Start 

Entry must be specified. This will be filled in with the location of 
the first marker position if the markers are set before this 
routine is entered. 

LENGTH 

Entry must be specified. This will be calculated from the positions 
of the first and second markers if the markers are set before this 
routine is entered. 

ASCII/EBCDIC 

This defaults to no translation. If specified the translation type 
must be one of the following: 

A ASCII to EBCDIC translation 
E EBCDIC to ASCII translation 

OUTPUT LOCATION START 

This entry indicates the starting position in the output record 
where the data is to be moved to. The program will pre-fill this 
with the next available output record position. 

NAME 

This entry may be used to assign a descriptive name or comment 
to the field being moved. The name entered will be displayed if 
the command statement is later edited. The field name will also 
be displayed by the program RECFMT. The name entered is 
stored in the control statement being created and will not 
appear in the actual output file. 

Screen Description—SELECT 

This is used to specify parameters for selecting or rejecting 
records from the input file. Note that if more than one of these 
statements is generated, the ORDER they are specified in is 
important. Once a SELECT condition is true the record is 
accepted without looking at following select/reject statements. 
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Once a REJECT condition is true the record is rejected without 
looking at any following select/reject statements. Records which 
are not specifically selected or rejected are processed. 

Any record which is neither selected or rejected will be processed 
if at least one reject statement has been entered. If there are 
one or more select statements and no reject statements all 
records not specifically selected will be rejected. 

Select/Reject 

An entry is required. 

S select record. 

R reject record. 

Records will be selected or rejected when the specified screen 
conditions are true. 

Compare 

Indicates type of compare operation for selection or rejection of 
records. Entries must be one of the following: 

EQ equal 
NE not equal 
GT greater than 
LT less than 
GE greater than or equal 
LE less than or equal 

In these comparisons the record data (first operand) is com¬ 
pared to a data constant (second operand). 

Field 

Specifies the type of field to compare. Valid entries are: 
A/E/X/Z/L/r/C/G/P/B/R. 

A ASCII text (assumed if no entry) 

E EBCDIC text 

X Hexadecimal data is supplied. 

The remaining indicators are numeric field specifiers. See the 
Help Screen description, page 168, for the list of numeric field 
types supported. 

Compare Data 

One or more bytes must be entered in the format specified 
above. If the string type is A or E then this must be a string of 
characters beginning and ending with a delimiter character. The 
delimiter character must not appear within the string. 
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Hexadecimal character must be entered as two hex digits per 
byte with one space between each byte and the next. If a 
numeric compare is specified enter the value to be compared to 
using a leading minus (-) if required. 

Beginning Position in input Record 

Must be specified. The program will fill this in from the position of 
the first marker if it was set prior to entering this routine. 

Numeric Field Length 

Entry must be specified for numeric compares. This will be filled in 
from the field markers if the markers are set before this routine 
is entered. 

Numeric Field Translation 

This entry specifies a text translation of the input numeric field 
before it is evaluated. This is not normally necessary but is 
NEVER VALID for packed decimal or binary fields. If entry is 
specified the indicator must be either: 

A ASCII to EBCDIC translation 
E EBCDIC to ASCII translation 

Screen Description—NUMERIC 

This screen is for specifying conversion of a numeric field from 
input to output. To see a list of the types of numeric fields 
supported press FIO to toggle between the numeric field help 
screen and displaying the data record. 

Input Type of Field 

Must be one of the eight valid numeric field types. See field type 
description. 

Input Beginning Position 

This is pre-filled with the position of the first marker if the marker 
was set before entering this screen. 

Input Field Length 

This entry is pre-filled by the program based on the position of 
the first and second markers if they were set before entering 
this screen. 

Input Translation 

This entry is optiorial and not normally required. If specified it 
causes a CHARACTER translation to be performed on the input 
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field before numeric evaluation. If the input is specified as packed 
decimal or binary no translation is valid. Valid indicators are: 

E translate from EBCDIC to ASCII 
A translate from ASCII TO EBCDIC. 

Output Type of Field 

Must be one of the eight valid numeric field types. See field type 
description. 

Output Beginning Position 

This is pre-filled by the program with the next available output 
record position. 

Output Field Length 

The length specified must be sufficient to contain the converted 
values and varies depending on the type of field specified. If 
(ENTER) is pressed without entering this field the program will 
calculate the required field length based on the type and length 
of the input field and the type of output field specified. The 
calculated value will be displayed and may be accepted by 
pressing (enter) again or the value may be changed before 
pressing (enter) . 

Output Translation 

This is optional and not normally needed. If specified a 
CHARACTER translation will be performed on the output field 
after it has been generated by the numeric conversion. 
Translation is never valid for packed decimal or binary output 
fields. Valid indicators are: 

E translate from EBCDIC to ASCII 
A translate from ASCII TO EBCDIC. 

Once a numeric new conversion statement has been generated 
the program will return to this screen. The entries on the screen 
will be pre-filled to convert the next sequential bytes of the input 
record in the same length and type as the previous command 
statement. This is done because numeric fields often occur in 
several sets in a record. To accept the pre-filled entries press 
(ENTER) to generate the next statement. The entries may be 
modified on the screen lo generate a command statement with 
new parameters or the (Is^ key may be pressed to return to 
the main menu. 
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Name 

This entry may be used to assign a descriptive name or comment 
to the field being converted. The name entered will be displayed 
if the command statement is later edited. The field name will also 
be displayed by the program RECFMT. The name entered is 
stored in the control statement being created and will not 
appear in the actual output me. 

Screen Description—FINAL 

This screen is entered when option six is chosen from the main 
screen. 

Output Data File 

Specifies the output DOS file to be generated by the conversion. 

Record Type 

This entry is required and must be one of the following; 

F for fixed length records. 

V for variable length records. 

If V is specified the program adds a carriage return and line feed 
(hexadecimal OD OA) to the end of each output record. 

Record Length 

This entry is required. The program pre-fills this field with the 
highest output record location previously specified by any of the 
conversion statements generated. 

Skip 

This entry is optional. Enter the number of records to skip before 
starting to process the file. 

Process 

This entry is optional. Enter the maximum number of records to 
process from the input file. 

Speed 

This entry is optional. Specify L or H to force the tape drive to 
low or high speed. 

Address 

This entry is optional. For tape input files only. Specify a tape 
unit address from 0 to 7. If not entered it defaults to address 0. 
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ASCII to EBCDIC Table 

This entry is optional. If entered the conversion program reads 
the first 256 bytes of the file (table) indicated and uses the data 
for any requested ASCII to EBCDIC conversions. 

EBCDIC to ASCII Table 

This entry is optional. If entered the conversion program reads 
the first 256 bytes of the file (table) indicated and uses the data 
for any requested EBCDIC to ASCII conversions. 

Sample 

This entry is optional. If entered this entry indicates a record 
sample rate. For example if a five is entered every fifth record 
will be processed rather than all records from the input file. 

Scr een Dgs cri ptipn—HEUP 

(Numeric Field Types) 

The help screen explains the numeric field indicators used by the 
program. A short field description appears on the screen for 
each indicator. 

The following types of numeric fields are supported. The letter 
code to the left must be used in screen entries to indicate a 
particular field type. When specified as input these formats are 
expected by the program. When specified as output these 
formats will be generated by the program. 

Z 

Zoned decimal. EBCDIC characters with a possible zone over the 
low order digit to specify the sign. A hex D zone specifies a 
negative number. The normal positive zone is hex C or hex F . 

The maximum length is fifteen (15) digits. 

L 

ASCII numeric characters with a possible leading or - sign. The 
sign character may be preceded by blanks in the input field and 
the lack of a (-) sign is taken to mean a positive number. On 
output the first position of the field will be either (+) or (-) and 
the digit positions will be left zero filled. The maximum total 
length is sixteen (16) bytes. 
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T 

ASCII numeric characters with a possible trailing + or - sign. The 
lack of a (-) sign is taken to mean a positive number. On output 
the last position of the field will either be (-h) or (-) and the digit 
positions will be left zero filled. The maximum total length is 
sixteen (16) bytes. 


C 

ASCII numeric characters with a possible trailing CR in the last 
two positions for negative numbers. The lack of a trailing CR is 
taken to mean a positive number. On output the last two 
positions will be either blank or CR. The maximum total length is 
seventeen (17) bytes. 


G 

ASCII numeric characters with a possible trailing DB in the last 
two positions for negative numbers. The lack of a trailing DB is 
taken to mean a positive number. On output the last two 
positions will be either blank or DB. The maximum total length is 
seventeen (17) bytes. 


P 

Packed decimal. One decimal digit per nibble with a sign in the 
lowest order nibble. The negative sign is a hex D and the positive 
sign is normally a hex C or F . The maximum length is 8 b>kes 
which is fifteen (15) decimal digits. 

B 

Binary with the most significant byte first and least significant 
byte last. The maximum length is eight (8) bytes. 

R 

Binary with the least signiicant byte first and the most 
significant byte last. This is the most common format for binary 
fields in microcomputers. The maximum length is eight (8) bytes. 

RECONT.EXE Program 

Once a control file has been generated by EXTRACTT the control 
file may be submitted directly to RECONT by entering the 
control file name after RECONT on the DOS command line. 
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The input and output file specifications in the control statement 
file may be overridden while still using the remainder of the 
statements in the control file. To do this just enter input and 
output file names on the command line after the control file 
name. For example: 

C:>recont sample.ctl c:\newinput.dat a:newout.dat 
will execute the program RECONT using the control statements 
in the file SAMPLE.CTL. However regardless of the files named 
as input and output files the input data will be taken from 
C:\NEWINPUT.DAT and the output created will be 
AiNEWOUT.DAT. 

Error Statements 

If an error is detected in an input control statement then the 
following message is displayed and the program is terminated. 

nn ERROR ON CONTROL STATEMENT. SEE 
DOCUMENTATION. PROGRAM ABORTED. 

Error Messages Listed by Number 

01 —^The second position of a translation table statement is not 
A or E. 

02—^The first statement is not a file definition statement. 

03—INSERT. No trailing delimiter was found within 60 

characters. 

04—Unused. 

05—^The input file type is not F or V . 

06—^The output file type is not F or V. 

07—^The input file record length is invalid. 

08—^The output file record length is invalid. 

Input Field Errors 

09—^An input field translation has not been specifed with a 
blank A or E. 

10— ^The input field type was not recognized. 

11— ^The input field length was too long. 

12— ^The the input field length was zero. 

13— The input field extends beyond the end of the record. 

Output Field Errors 

14— ^The output field translation is not blank A or E . 

15— ^The output field type was not recognized. 

16— ^The output field length was too long. 

17— ^The output field length was zero. 
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18— ^The output field extends beyond the end of the record. 

Field Conversion Errors 

19— FILL field translation is not blank or A. 

20— FILL field extends beyond the end of the record. 

21— INSERT field translation indicator is not blank or A . 

RECONT.EXE 

21 —NSERT field translation indicator is not blank or A . 

22— INSERT field character string extends beyond the end of 
the record. 

23— MOVE field translation indicator is not blank A or E. 

24— MOVE input field extends beyond the end of the record. 

25— MOVE output field extends beyond the end of the record. 

26— FILL hexadecimal field translation indicator is not a blank. 

27— FILL hexadecimal field extends beyond the end of the 
record. 

28— SELECT/REJECT compare type is not EO/NE/GT/LT/GE/LE 

29— SELECT/R^ECT string does not (completely) fall within the 
specified input record. 

30— SELECT/REJECT field length is invalid. 

31— SELECT/RBECT string type is not E X blank or numeric. 

32— SELECT/REJECT string contains invalid characters. 

33— 36—Unused. 

37— FINAL skip or process count is invalid. 

38— SELECT/REJECT numeric pre-translation is not A/E/blank. 

TDE.BAT 

The batch file TDE.EAT executes both the EXTRACTT and RECONT 
programs so that a control file may be built and executed in one 
step. When using this batch program the name of the control 
file must be entered immediately after the program name: 

OTDE SAMPLE.CTL 

Once a control file has been built for converting a particular 
record format it need not be created again. It may be 
submitted directly to RECONT to convert another file with the 
same record format. (See RECONT program operation section.) 

RECFMT.EXE Program 

This program displays the conversion parameters contained in 
control statement files created by the EXTRACTT. EXE program. 
This display provides a complete field description of the records 
output by EXTRACTT. The display may be used to verily correct 
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processing of an input file or used to obtain an output record 
layout. The output record layout is usually required by an 
operator who must process the output file. 

The name of the control file to be displayed must be entered on 
the DOS command line following the program name when 
RECFMT is loaded. 

An output device must also be indicated on the DOS command 
line when RECFMT is loaded. If a device is not specified output 
defaults to LPTI (the printer). To direct output to the display 
screen specify CON as the device parameter. 

DOS Device Names for Use With RECFMT: 

CON—console (display monitor) 

PRN—printer (default address) 

LPTn—printer n (1 st printer is the same as PRN). 

Contrary to what IBM's manuals state, it is not necessary to 
use a colon after the device name (such as PRN;). 

Run RECFMT by typing its name at the DOS command prompt 
followed by the command file name and output device 
parameters: 

Orecfmt control.dat con 
The above command displays the statements in control file 
CONTROL.DAT to the display screen. RECFMT outputs a 
line-by-line description of the control file command statements. 
Each statement from the file is displayed in the following format: 
Statement number. 

Input field beginning position 
Input field ending position 
Output field beginning position 
Output field ending position 
Operation performed (MOVE FILL etc.) 

Field name assigned by EXTRACTT or user. 
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INSUTIL.EXE 

(COLOR AND PARAMETERS INSTALLATION PROGRAM) 

This program allows the user to change screen colors and 
parameters used by the Flagstaff Engineering TAPEUTL or 
EXTRACTD programs. In response to the request for NAME OF 
PROGRAM, enter the full program name, for example, 
TAPEUTLEXE . Colors are specified for three types of display 
attributes: 

NORMAL used for displaying most prompts, text, etc. 
ENHANCED used for operator entry fields and error messages 
REVERSED used to highlight selected data (EXTRACT only) 

When a new color is requested, pressing the return leaves it 
unchanged. The following color values should be used to indicate 
the desired display colors: 

FLAGSTAFF ENGINEERING - INSTALL PROGRAM OPTIONS 


Program name: TAPEUTL.EXE 

Screen display colors Foreground 

0= Black 8= Dark Grey 0123456789ABCDEF 

1 = Blue 9= Light Blue Oxxxxxxxxxxxxxxxx 

2= Green A= Light Green Ixxxxxxxxxxxxxxxx 

3= Cyan B= Light Cyan 2xxxxxxxxxxx x x x x x 

4= Red C= Light Red 3xxxxxxxxxxxxxxxx 

5= Magenta D= Light Magenta 4xxxxxxxxxxxxxxxx 

6= Brown E= Yellow Sxxxxxxxxxxxxxxxx 

7= Light Grey F= Bright White Sxxxxxxxxxxx x x x x x 

7XXXXXXXXXXXXXXXX 
Normal Background 1 Foreground 7 8xxxxxxxxxxxxxxxx 

Enhanced Background 1 Foreground F 9xxxxxxxxxxxxxxxx 

Reversed Background 7 Foreground 1 Axxxxxxxxxxxxxxxx 

Bxxxxxxxxxxxxxxxx 
Cxxxxxxxxxxx X X X X X 
Dxxxxxxxxxxx x X X X X 
Exxxxxxxxxxxxxxxx 
Fxxxxxxxxxxx X X X X X 


Press <ESC> to exit without update 

Color Select Screen 

After colors and parameters have been chosen, the same screen 
will display lines using the colors selected in this manner: 

This is a normal line (x, the color you selected) 
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This is a bright line (x, the color you selected) 

This is a reverse line (x, the color you selected) 

You can also set default parameters of your choosing with Tape 
Utility. The options chosen from this screen will be the default 
values that the program will use to pre-fill these fields whenever 
TAPEUTL is run. 


FLAGSTAFF ENGINEERING - INSTALL PROGRAM OPTIONS 

Program name: TAPEUTL.EXE 

System parameters- 

Read buffer length 16384 Tape retries 15 Tape address 0 

Tape to disk defaults--- 

Translate data? (N=no, A=EBCD1C to ASCII, E= ASCII to EBCDIC) N 
Data type; (F)ixed, (V)ariabie, (1)BM variable, (S)tring S 
Record length 0 Strip pad characters (YIN) N Insert line end (Y/N) N 
Pad character Line end characters OD OA 

Disk to tape defaults- 

Translate data? (N=no, A=EBCD1C to ASCII, E- ASCII to EBCDIC) N 
Data type: (F)ixed, (V)ariable, (l)BM variable, (S)tring S 
Block size 4096 Record size 128 Records per block 32 
Pad character Line end characters OD OA 

Press <ESC> to exit without update 

Parameters Installation Screen 

At the end, this screen displays verified updates were made thus: 
Color defaults updated 
Taputl defaults updated 
C> 
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Tape Backup 

TAR 

TAR is a tape file archive program for Overland Data's 7X-8,TXi- 
16 or XI_/2 tape controller. It produces standard TAR-format 
tapes readable by other systems with a tar command, tar is a 
standard format on UNIX and XENIX systems, thus tapes 
produced by this MS-DOS tar program are readable on most 
UNIX or XENIX systems. 

TAR has existed since UNIX Version 7, with very little change. It 
is an excellent data interchange program for UNIX and XENIX 
systems, and now, MS-DOS systems, since it can be invoked 
from the command line and requires no further assistance. 

Features 

TAR is a command line archive program, providing a way to 
store many files in a single archive, which can be kept in a file or 
stored using an I/O device such as a tape drive. It is useful for 
making backups or preparing files for transfer to another 
system. 

TAR does the following; 

■ Writes a set of files to tape or another file as a single archive. 

■ Extracts one or more files from an archive. 

■ Can create a "table of contents" of the files in an archive. 

■ Can specify the file names to access in an archive by listing 
them on the command line, specifying a directory hierarchy, 
or specifying a file that contains a list of file names (one per 
line). 

When reading a tape archive, this version of tar implements 
limited error handling. It automatically retries after certain kinds 
of errors. There are no options for changing error handling 
capabilities. 

Options 

Specify tar options in the command line by keyletters. /Ml option 
keyletters form the first argument to tar. The arguments for 
those options which require arguments form the second, third, 
etc. arguments. The files to be manipulated are listed by name 
after all other arguments. 
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Note: When creating an archive, it is generally a bad idea to 
specify full path names. When you extract the files with full 
path names, tar puts them exactly where they were taken 
from. A better idea is to go to the top level directory, and use 
relative file names, letting you extract the files to another 
hierarchy. 

For example: 

C:\> 'tar cv£b archive 10 filel £ile2 
cv£b specifies keyletters c, create archive; v, verbose mode; £, 
the archive name is the next argument and b, the blocking 
factor is the next argument (following the archive name), c 
and V require no arguments, so the first argument, archive, 
is the archive name and 10 is the blocking factor. If £ and b 
were entered in reverse order (cvb£), then the arguments 
would also need to be entered in the reverse order. £iiel 
and £iie2 are the list of files to archive. 

TAR supports the following options: 

b Specifies a blocking factor for the archive. The block size will 
be N X 512 bytes. Larger blocks usually run faster and let 
you put more data on a tape. The default blocking factor is 
20 (the most commonly used value). 

Requires a numerical argument (as shown above). 

Note: You may specify a blocking factor from 1 to 20. 

B When reading an archive, tar reblocks as it reads. 

Normally, tar reads each block with a single read system 
call. Using this option, it does multiple reads until it gets 
enough data to fill the specified block size, b can also be used 
to speed up the reading of tapes that were written with 
small blocking factors, by specifying a large blocking factor 
with b and having tar read many small blocks into memory 
before it processes them. 

No argument is needed by this option, 
c Creates an archive from a list of files or directories. 

Specifying a directory name archives that directory and all 
the files it contains, including any subdirectories. 

No argument is needed by this option. 

D Each time that tar produces a message, this option prints 
the record (tape block) number where the message 


176 



Chapter 5—Backing up Your Data to Tape 

occurred. This is especially useful when reading damaged 
archives, helping pinpoint the damaged section. 

No argument is needed by this option. 

f Specifies the archive filename (the filename is a required 
argument for this option). If the filename used is a dash ('- 
") the archive is read from the standard input or written to 
the standard output. If the option is not used, tar writes 
to the 9-track tape controller. 

k When extracting files from an archive, this keeps existing files 
on the destination medium intact, rather than overwriting 
them with the version from the archive. 

No argument is needed by this option. 

m When extracting files from an archive, this sets each file's 
modified timestamp to the current time, rather than 
extracting each file's modified timestamp from the archive. 

No argument is needed by this option. 

t Lists a table of contents for an existing archive. If file names 
are specified, it lists only files matching the specified names. 

No argument is needed by this option. 

T Allows you to specify that the file names tar will operate on 
will be read from the file used as the argument, (with only 
one file name listed per line in that file). The file is a required 
argument for this option. If the argument is a dash (''-") 
then the list is read from the standard input. 

V This option instructs tar to be verbose about the files being 
processed or listed. It provides additional information about 
each file, like size and date. Without this option, tar lists 
only the file names. 

No argument is needed by this option. 

w This option allows you to define the time when tar will run. 
The time is set on a 24-hour clock, so you can define any 
time, up to 24 hours in the future, for tar to run. The 
argument form must be two digits, followed by a colon, 
which must be followed by two digits. Thus, midnight is 
24:00, and 1 ;30 a.m. is Oi: 30. 

w Suppresses the 'wait for user approval to exit keystroke' 
(normally the program waits for a user keystroke before 
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exiting, to allow you to see what has been done; this switch 
tells it not to wait). 

No argument is needed by this option. 

X Extracts files from an existing archive. If file names are 
specified, it extracts only the files matching those names, 
otherwise it extracts all the files in the archive. 

No argument is needed by this option. 

Note: TAR will read and write multi-volume tape sets. 

Warnings 

In order to be compatible with UNIX and XENIX, tar writes file 
path names using forward slash notation (/), instead of the 
DOS convention of using a back slash (\). With this tar 
program you may specify path names using either notation 
during a create, but you must use the forward slash to extract 
files. 

TAR does not convert MS-DOS style text files (carriage-return 
line-feed delimited text lines) to UNIX style text files (line-feed 
delimited), tar also does not convert UNIX style text files to MS- 
DOS style text files. 

TAR converts UNIX-style file names which are illegal under DOS 
to a legal form, naming such files T$nnnn. gen, where nnnn is a 
four digit number starting with 0000 and running through 
9999. 

Examples 

The following command writes a tar tape to the default device 
(the TX-8 controller). 

C:\ tar cv . 

Options c means create, and v means verbose mode. The dot 
or period (.) identifies all the files and directories in the current 
directory as the files to be archived. 

The next command creates an archive of all files and directories 
under directories usr and bin. 

C:\ tar cv usr bin 

This specifies the relative path name for usr and bin instead of 
using a full (absolute) path name (such as \usr or \bin). 

To see a table of contents listing of the archive created in the 
previous command, we use the following command. 
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C:\ tar Dtv 

Option D tells us the exact block number where each file starts, 
t provides the listing, and v means verbose mode. 

Alternatively, the listing could be stored in a separate file, one 
file per line, with the following command; 

C:\ tar t > filelist 

This places the table of contents in the file filelist, using the 
DOS redirection symbol >. 

To extract files from an archive, use option x. The following 
example extracts all the files from the default archive. 

C:\ tar xv 

Option X extracts the files and v means verbose mode. 

The following command creates an archive using the installed 
device driver, mtO. 

C:\ tar cvfbT mtO 30 filelist 

Option c means create the archive, v is verbose mode, f 
specifies that the next argument is the archive device (since this 
is the first option requiring an argument, the first argument, 
the archive device name, is mtO), b means the next argument is 
the blocking factor (since this is the second option requiring an 
argument, the second argument, the blocking factor, is the 
numerical value 30) and t means the next argument (after the 
blocking factor) names a file, filelist, containing a list of file 
names to archive. 

Note: Check that you have installed the device driver before 
using this command; tar will otherwise write the archive to 
a simple file called mtO. 
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Archive Format 


This table shows the fields for this version of tar, the number of 
bytes each field can contain and whether DOS uses the field. 

The name is in ASCII, all other header fields are octal numbers 


represented with ASCII characters. 


Name 


File Protection Mode 


User ID 


Group ID 


File Size 


Modification Time 


Check Sum 


Unk Fla 


Link Name 



. 


Files concatenated are all 512 byte records (may be blocked 
differently from tape records). 



table header 

Specified header (see table) 

Limitations 

Tar continues to scan all files on tape even after the 
requested files have been found. This is normal operation, 
and is necessary, since you can append to a backup—a 
later version of the file might exist further down the tape. 
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Controller Specifications 

TX-8 and XL/2 Specifications 

TX-8 and XL/2 Input Output Map 

Default base port address as shipped (hex); 


TX-8 and XU2 Input Port Map 

Offset From Base Port 

Port Function 

BASE+0 

Tape Status Byte A 

'BASE+1 

Tape Status ^e B 

BASE+2 

fape/fx Error Status 

BASE+3 

Tape Read Data 

BASE+4 

1 fx Cache Count Read (Low Byte) 

BASE+5 

fx Cache Count Read (High ^e) 

BASE+6 

Reserved 

‘bASE+7 

Reserved 


TX-8 and XL/2 Output Port Map 

Offset From Base Port 

Port Function 

BASE+0 

Tape Command Byte 

BASE+l 

tape Control Byte 

BASE+2 

tx Control Byte 

BASE+3 

tx Extended Control Byte 

“bASE+4 j 

tx Cache Count Set (Low Byte) 

‘bASE+5 

tape Write Data 

BASE+6 

tx Cache Count Set (High Byte) 

'bASE+7 I 

tx Adder Offset Set 
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TX-8 and XL/2 Status Input Bit Map 
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0-7 

CACHE COUNT 
(Low Byte) 

yes 

PORT 5 

—TX CACHE COUNT HIGH 

0-7 

CACHE COUNT 
(High Byte) 

yes 

PORT 6—RESERVED 

PORT 7—RESERVED 


TX-8 and XL/2 Output Bit Map 
BASE+0 (Tape Command Bytel: 

This port is used to send commands to the tape drive as follows: 



BASE+O 

; TAPE COMMAND BYTE 

|!g9 

ERASE 

EDIT 


WRT 

REV 


HU 

(D4) 

(D3) 

USB 

(Dl) 

(DO) 

Function Initiated 

BH 

0 

0 

0 

0 

0 

Read 1 block fwd 


0 

0 

0 

0 

1 

Read 1 block back 

fSM 

0 

1 

0 

0 

1 

Read reverse edit 


0 

0 

0 


0 

Write I block fwd 


0 

1 

0 

!■ 

0 

Overwrite 


0 

0 

1 

!■ 

0 

Write file mark 


njliBII 

0 

0 

BB 

0 

Erase variable block 



0 

1 


0 

Erase fixed block 


IH 

1 

1 

!■ 

0 

Security erase 

BH 


0 

0 

0 

0 

Skip fwd 1 block 


■■ 

0 

0 

0 

1 

Skip back I block 


1 

1 

0 

0 

0 

No operation 


■■ 

!■ 

!■ 

0 

0 

Select 1600 bpi t 

Bi 


!■ 

!■ 

0 

] 

Select 3200 bpi t 

0 

BM 




H 

Select 25 IPS t 

1 


BB 

BB 

HI 

H 

Select 100 IPS t 


These operations are drive dependent. Check the tape drive nnanufacturer 
specifications. 


The data written to the tape command port is latched and a 
pulse approximately 750 nanoseconds wide is produced and 
presented to the IGO interface line concurrently with the data. 
Data bits D6 and D7 are not used. 
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BASE+1 (Tape Control Byte): 



BASE+l : 

TAPE CONTROL BYTE 

0 

TADI 

Drive Select LSB. 

1 

TADO 

Drive Select. 

2 

FAD 

Drive Select MSB. 

3 

UNLD 

Drive Unload. 

4 

FEN 

Clear formatter. 

5 

RWD 

Rewind to BOT . 

6 

RTHl 

Read Threshold 1 
(Reserved) 

7 

RTH2 

Read Threshold 2 
(Reserved) 



BASE+2 ; BOARD CONTROL BYTE 

Proprietary 

BASE+3 (Pulse Decodes): 

BASE+3 : PULSE DECODES 

Proprietary 

Value of 2 STATRST Status Reset 


BASE+4 ; LOAD CACHE COUNT (LB) 


BASE+5 ; TAPE WRITE DATA 

BASE+6 (Load Cache Count. High Byte): 

1 BASE+6 : LOAD CACHE COUNT (HB) 

BASE+7 (Adder Input): 

BASE+7 ; ADDER INPUT 

STATRST then LOW byte, HIGH byte 
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TX-8 User Options 

Address 

The TX-8 controller occupies eight consecutive I/O locations. /\n 
eight position dip switch (labeled on the board) allows you to 
address the board at any eight byte boundary within the 1024 
byte address range of the IBM PC/XT/AT. Generally, addresses 
from 200 (hexadecimal) to 3FF (hexadecimal) are available for 
board addressing. 

The following table shows the board addressed as shipped. Dip 
switch numbers 1 through 8 correspond to address lines A10 
through /\3, respectively, with address lines /\2, AI, and AO 
hardwired to logic 0. Switches set to the position represent a 
logic 0. Those set to the OFF position represent a logic 1. The 
table translates each On/Off setting to the equivalent binary. 

By combining the correct group of switches, the table shows 
the equivalent hexadecimal value. 


Line 

o > 

A9 

A8 

A7 

A6 

A5 

A4 

A3 

A2 

AI 

AO 

Switch 

1 

2 

3 

4 

5 

6 

7 

8 

- 

- 

- 

Position 

ON 

OFF 

OFF 

ON 

OFF 

OFF 

ON 

ON 

- 

- 

- 

Binary 

0 

1 

I 

0 

1 

I 

0 

0 

0 

0 

0 

Hex 

3 

6 

_2_1 


The following diagram shows the board's address dip switch 
setting as shipped. Black boxes towards the top indicate 
position ON; that is, logic 0. Black boxes towards the bottom 
indicate position OFF; that is, logic 1. 

The TX-8 software will automatically check for the board 
addressed at the default I/O port, 360 hexadecimal. If it is not 
detected, it will then check (in order) the following addresses: 

300H 310H 320H 330H 340H 350H 
You can change the I/O base port on a TX-8 controller without 
running config if the new base port you select appears in the 
table below. 
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DIP Switch 

1 

2 

3 

4 

5 

6 

7 

8 

Address Line 

AlO 

A9 

A8 

A7 

A6 

A5 

A4 

A3 

360 (default) 

ON 

' OFF 

OFF 

ON 

OFF 

OFF 

ON 

ON 

300 

ON 

OFF 

OFF 

ON 

ON 

ON 

ON 

ON 

310 

ON 

OFF 

Off 

ON 

ON 

ON 


ON 

320 

ON 

I OFF 

OFF 

ON 

ON ' 

t-ofr 

1 ON 

1 ON 

330 

ON 

i OFF 

OFF 

ON 

1 ON 

i.9^L 

1 OFF 

l"bN"" 

340 

ON 

I OFF 

OFF 

ON 

[ OFF 

ON 

roFT 

1 ON 

350 

ON 

1 OFF 

OFF 

[ ON 

rOFF" 

ON 

1 OFF 

[ ON 


Set the DIP switch (located in the upper right corner of the 
board) as shown, and the I/O base port reconfiguration is 
complete. Normally, the software running with the controller 
would also have be reconfigured, but the supplied utility 
programs (as well as mto and alltape) include an automatic 
configuration routine which looks for the TX-8 controller at each 
listed address in turn, and configures accordingly if the board is 
found. 

The autcxonfigure feature is activated by selecting a base I/O 
address of 0 in config (this is the factory default). 

Note: The TX-8 I/O address auto-configure feature is available 
on program versions 2.0 and above only, and is not available 

for FLASHBAK . 

Unlisted base port addresses require you to determine the 
corresponding DIP switch settings, change the switches, and 
run CONFIG . 

If the default address of 360 hexadecimal conflicts with another 
device in your PC, set the controller’s I/O address dip switch to 
one of the above settings and the software will automatically 
detect the new I/O address. 

Interrupt Level 

Interrupts may be generated upon completion of any data 
transfer command. The current MS-DOS software does not 
require interrupts (the default setting uses the timer tick 
interrupt, IRO 8). To enable interrupts, shunt one of the 
following pin pairs. Interrupts will be generated only when 
Data Busy goes false. Writing to the command port will reset 
this interrupt. 


186 




Appendix A—Controller Specifications 


Interrupt Vector 

Pin 

IRQ3 


IRQ4 


IRQ5 

C(5) 

IRQ6 

D(6) 

IRQ7 

E(7) 

IRQ9 

F(9) 

IRQ 10 

H (10) 

IRQ! 1 

J (11) 

IRQ 12 

K(12) 

IRQ 14 

L(I4) 

IRQ 15 

M (15) 


Interrupt pins are labeled either with the above Letter (such as 
A), or simply with the Interrupt Vector Number (such as 3). 
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XL/2 User Options 

Configuration of the XLy2 Tape Controller is simple and easy. 

There are no switches to set or jumpers to move. Once the card 
is inserted correctly into the computer, the software supplied on 
the IBM Reference Diskette in concert with the Automatic 
Configuration File supplied by Overland Data (file @7E7 6.adf 
on the UTILITIES disk) will handle the entire process. 

This section describes each of the configurable settings available. 
Normally you let the Configuration Program automatically 
select the appropriate settings. In some cases you may want to 
change them to solve a configuration conflict or to better 
match your environment. 

The XL/2 options that are configurable and their default settings 
are listed below. 


Option 

Default Setting 

I/O Address 

360 hexadecimal 

Interrupt Level 

10 decimal 

Drive Address 

0 

Pin J2-50 

Low 

Streaming or Start/Stop 

Streaming 


Address 

The XL/2 uses 8 contiguous I/O addresses and can be addressed 
to any base address on even boundaries of 8 (0000 to FFF8 
hex). Much of the address space below 400 hex is used by IBM. 

The default address used by the XL/2 is 360 hex. If this conflicts 
with any other device (indicated by next to the selection), make 
another selection. 

Interrupt Level 

The IBM PS/2 has 11 interrupt levels available on the Micro 
Channel bus. This selection allows you to select any one of 
these, or to disable the hardware interrupts. The Overland 
Data software chains into the DOS system clock interrupt (IRO 
8) if the hardware interrupt is disabled. 

The default interrupt level is 10 (decimal). If this conflicts with 
another hardware device, select another interrupt level. 
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Drive Address 

This selection allows you to specify which drive address the Xl/2 
will select when the unit is first powered on. Normally, you 
should specify drive address 0. 

j2-50 Density Speed Select 

Pin number 50 on the J2 connector is used on some drives to 
select either one of two speeds or one of two tape densities. 
Refer to the tape drive documentation for the interpretation of 
this signal by your tape drive. The default setting sets this signal 
to low. 

Streaming or Start/Stop 

The selection of streaming or start/stop mode alters the 
sequence of commands issued by the software to the tape 
transport. The normal selection is streaming (for streaming 
tape drives). A few older drives may have trouble with 
commands being issued before the formatter-busy (IFBSY) line 
indicates that the formatter is not busy. This problem 
sometimes causes the tape drive to quit functioning until it is 
reset. In these rare cases, try the start/stop setting. 

If you select start/stop on a streaming drive, you may 
experience a degradation in performance. This will manifest 
itself as an increase in tape repositioning. 
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Translation Tables 

Control character representations used in these translation 


tables 




ACK 

Acknowledge 

IGS 

Interchange Group 
Separator 

BEL 

Bell 

IL 

Idle 

BS 

Backspace 

IRS 

Interchange Record 
Separator 

CAN 

Cancel 

lUS 

InterchangeUnit Separator 

cc 

Cursor Control 

LC 

Lower Case 

CR 

Carriage Return 

LF 

Line Feed 

CUl 

Customer Use 1 

NAK 

Negative Acknowledge 

CU2 

Customer Use 2 

NL 

New Line 

CU3 

Customer Use 3 

NUL 

Null 

DC1 

Device Control 1 

PF 

Punch Off 

DC2 

Device Control 2 

PN 

Punch On 

DC4 

Device Control 4 

RES 

Restore 

DEI 

Delete 

RS 

Reader Stop 

DLE 

Data Link Escape 

SI 

Shift In 

DS 

Digit Select 

SM 

Set Mode 

EM 

End of Medium 

SMM 

Start of Manual Message 

ENQ 

Enquiry 

SO 

Shift Out 

EOT 

End of Transmission 

SOH 

Start of Heading 

ESC 

Escape 

SOS 

Start of Significance 

ETB 

End of Transmission Block 

SP 

Space 

ETX 

End of Text 

STX 

Start of Text 

FF 

Form Feed 

SUB 

Substitute 

FS 

Field Separator 

SYN 

Synchronous Idle 

HT 

Horizontal Tab 

TM 

Tape Mark 

iFS 

Interchange File Separator 

UC 

Upper Case 

VT 

Vertical Tab 
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EBCDIC-to-ASCII 


Out 

Disp. 

Char 

0x20 

SP 

OxOa 

LF 

0x17 

ETB 

Ox 1 b 

ESC 

0x20 

SP 

0x20 

SP 

0x20 

SP 

0x20 

SP 

0x20 

SP 

0x05 

ENQ 

0x06 

ACK 

0x07 

BEL 

0x20 

SP 

0x20 

SP 

0x16 

SYN 

0x20 

SP 

0x20 

SP 

Oxle 

RS 

0x20 

SP 

0x04 

EOT 

0x20 

SP 

0x20 

SP 

0x20 

SP 

0x20 

SP 

0x14 

DC4 

0x15 

NAK 

0x20 

SP 

Ox 1 a 

SUB 

0x20 

SP 

0x20 

SP 

0x20 

SP 

0x20 

SP 

0x20 

SP 

0x20 

SP 

0x20 

SP 

0x20 

SP 



































































































































































































































































Appendix A—Controller Specifications 










































































































































































































Appendix A—Controller Specifications 



0xd3 

L 

0xd4 

M 

0xd5 

N 

0xd6 

O 

0xd7 

P 

0xd8 

Q 

0xd9 

R 



Out 

0x20 

0x20 

0x20 

0x20 

0x20 

0x20 

0x5d 

0x20 

0x20 

0x7b 

0x41 

0x42 

0x43 

0x44 

"O)^ 

0x46 

0x47 

0x48 

0x49 

0x20 

0x20 

0x20 

0x20 

0x20 

0x20 

0x7d 

0x4a 

0x4b 

0x4c 

0x4d 

0x4e 

0x4f 

0x50 

ox?r 

0x52 

0x20 

0x20 
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In 

Disp. 

Char 

Out 

Disp. 

Char 

In 

Disp. 

Char 

Out 

Disp. 

Char 

Oxdc 


0x20 

SP 

Oxee 


0x20 

SP 

Oxdd 


0x20 

SP 

Oxef 


0x20 

SP 

Oxde 


0x20 

SP 

OxfO 

0 

0x30 

0 

Oxdf 


0x20 

SP 

Oxfl 

1 

0x31 

1 

OxeO 


Ox5c 

\ 

0xf2 

2 

0x32 

2 

Oxe 1 


0x20 

SP 

Oxf3 

3 

0x33 

3 

0xe2 

s 

0x53 

s 

0xf4 

4 

0x34 

4 

0xe3 

T 

0x54 

T 

0xf5 

5 

0x35 

5 

0xe4 

U 

0x55 

u 

0xf6 

6 

0x36 

6 

0xe5 

V 

0x56 

V 

Oxf7 

7 

0x37 

7 

0xe6 

w 

0x57 

w 

0xf8 

8 

0x38 

8 

0xe7 

X 

0x58 

X 

0xf9 

9 

0x39 

9 

OxeS 

Y 

0x59 

Y 

Oxfa 


0x20 

SP 

0xe9 

z 

0x5a 

z 

Oxfb 


0x20 

SP 

Oxea 


0x20 

SP 

Oxfc 


0x20 

SP 

Oxeb 


0x20 

SP 

Oxfd 


0x20 

SP 

Oxec 


0x20 

SP 

Oxfe 


0x20 

SP 

Oxed 


0x20 

SP 

Oxff 


0x20 

SP 
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ASCII-to-EBCDIC 


In 


Out 

Disp. 

Char 

0x00 

NUL 

0x01 

SOH 

0x02 

STX 

0x03 

ETX 

0x37 

EOT 

0x2d 

ENQ 

0x2e 

ACK 

0x2f 

BEL 

0x16 

BS 

0x05 

HT 

0x25 

LF 

OxOb 

VT 

OxOc 

FF 

OxOd 

CR 

OxOe 

SO 

OxOf 

SI 

0x10 

OLE 

0x1 1 

DCl 

0x12 

DC2 

0x13 

TM 

0x3c 

DC4 

0x3d 

NAK 

0x32 

SYN 

0x26 

ETB 

0x18 

CAN 

0x19 

EM 

0x3f 

SUB 

0x27 

ESC 

0x22 

FS 

Ox 1 d 

IGS 

Oxle 

IRS 

Ox If 

lUS 

0x40 

SP 

0x5a 

! 

0x7f 

" 

0x7b 

# 


0x24 


0x25 


0x26 


0x27 


0x28 


0x29 


0x2a 


0x2b 


0x2c 


0x2d 


0x2e 


0x2f / 


0x30 


0x31 


0x32 


0x33 


0x34 


0x35 


0x36 6 


0x37 7 


0x38 8 


0x39 


0x3a 


0x3b 


0x3c 


0x3d 


0x3e 


0x3f 
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NUL 

NUL 

NUL 

NUL 

NUL 

NUL 

NUL 

NUL 

NUL 

NUL 

NUL 

NUL 

NUL 

NUL 

NUL 

NUL 

NUL 
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In 

0x93 

0x94 

0x95 

0x96 

0x97 

0x98 

0x99 

0x9a 

0x9b 

0x9c 

0x9d 

0x9e 

0x9f 

OxaO 

Oxa I 

0xa2 

0xa3 

0xa4 

0xa5 

0xa6 

0xa7 

0xa8 

0xa9 

Oxaa 

Oxab 

Oxac 

Oxad 

Oxae 

Oxaf 

OxbO 

Oxbl 

0xb2 

0xb3 

0xb4 

0xb5 

0xb6 










































































































































































































Appendix A—Controller Specifications 


In 

Disp. 

Char 

Out 

Disp. 

Char 

In 

Disp. 

Char 

Out 

Disp. 

Char 

Oxdc 


0x00 

NUL 

Oxee 


0x00 

NUL 

Oxdd 


0x00 

NUL 

Oxef 


0x00 

NUL 

Oxde 


0x00 

NUL 

OxfO 


0x00 

NUL 

Oxdf 


0x00 

NUL 

Oxfl 


0x00 

NUL 

OxeO 


0x00 

NUL 

0xf2 


0x00 

NUL 

Oxe 1 


0x00 

NUL 

0xf3 


0x00 

NUL 

0xe2 


0x00 

NUL 

0xf4 


0x00 

NUL 

Oxe3 


0x00 

NUL 

0xf5 


0x00 

NUL 

0xe4 


0x00 

NUL 

0xf6 


0x00 

NUL 

0xe5 


0x00 

NUL 

0xf7 


0x00 

NUL 

0xe6 


0x00 

NUL 

0xf8 


0x00 

NUL 

0xe7 


0x00 

NUL 

0xf9 


0x00 

NUL 

0xe8 


0x00 

NUL 

Oxfa 


0x00 

NUL 

0xe9 


0x00 

NUL 

Oxfb 


0x00 

NUL 

Oxea 


0x00 

NUL 

Oxfc 


0x00 

NUL 

Oxeb 


0x00 

NUL 

Oxfd 


0x00 

NUL 

Oxec 


0x00 

NUL 

Oxfe 


0x00 

NUL 

Oxed 


0x00 

NUL 

Oxff 


0x00 

NUL 
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Limited Warranty 

Products covered by this Warranty are limited to products 
manufactured by Overland Data Inc. This includes tape controller 
board products only, and specifically excludes tape transports or tape 
drives. Overland Data warranties for tape drive or tape transport 
products are specific to the make and model of transport delivered, 
and are covered individually. 

Overland Data Inc. warrants to the original purchaser of this 
Overland Data Inc. tape coupler product that it is to be in good 
working order for a period of two years from the date of purchase 
from Overland Data Inc. or an authorized Overland Data Inc. dealer. 

Should this product malfunction during the warranty period. 

Overland Data Inc. will, at its option, repair or replace it at no 
charge, provided that the product has not been subjected to misuse, 
abuse, or non-Overland Data Inc. authorized alterations, 
modifications, and/or repairs. 

Should a product require Limited Warranty service during the 
warranty period, a Returned Material Authorization (RMA) must be 
obtained prior to returning the product to Overland Data Inc. Any 
item returned for repair under the terms of this warranty must be 
accompanied by proof of purchase. You agree to insure the product 
or assume the risk of loss or damage in transit. You also agree to 
prepay shipping charges to Overland Data Inc. 

ALL EXPRESS AND IMPLIED WARR/KNTIES FOR THIS PRODUCT 
INCLUDING, BUT NOT LIMITED TO, THE WARRANTIES OF 
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ARE 
LIMITED IN DURATION TO THE ABOVE TWO YEAR PERIOD. Some 
states do not allow limitations on how long an implied warranty lasts, 
so the above limitations may not apply to you. 

UNDER NO CIRCUMSTANCES WILL OVERLAND DATA INC. BE LIABLE 
IN ANY WAY TO THE USER FOR D/WIAGES, INCLUDING ANY LOST 
PROFITS, LOST SAVINGS, OR OTHER INCIDENTAL OR 
CONSEOUENTIAL DAMAGES ARISING OUT OF THE USE OF, OR 
INABILITY TO USE, SUCH PRODUCT. Some states do not allow the 
exclusion or limitation of incidental or consequential damages for 
consumer products, so the above limitation or exclusion may not 
apply to you. 

THIS WARRANTY GIVES YOU SPECIFIC LEGAL RIGHTS, AND YOU 
MAY ALSO HAVE OTHER RIGHTS WHICH MAY VARY FROM STATE TO 
STATE. 

The limited warranty applies to hardware products only. 
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5600 Kearny Mesa Ret., 

San Diego, CA 92111-1383 
TEL: (619) 571-5555 
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